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Preface 


The objective of this book is to help installation managers and system programmers 
plan for, install, and use SMF in an MVS/XA system. This book describes: 


The basic relationship of SMF to the operating system 
Possible uses of SMF data 


How to add user-written routines to the appropriate SMF exits either before 
or after SYSGEN 


The system areas that require additional storage for SMF and approximately 
how much additional storage is needed in each area 


How to execute the SMF dump program 


How to use an SMFPRMxx member of SYS1.PARMLIB to define the use of 
SMF 


How to write records to installation-defined or SMF-defined data sets 


How to plan and write exit routines that will monitor jobs or job steps at various 
points during their processing cycle 


How to test user-written routines using the TESTEXIT procedure 
How to design report programs that format and print the data from SMF records 


The information contained in each SMF record 


Note: In addition to Version 2 of the MVS/System Products, this edition also 
includes the following program products: 


OS/VS2 MVS Programmed Cryptographic Facility 5740-XY5 
OS/VS2 MVS Cryptographic Unit Support 5740-XY6 

OS/VS2 MVS ACF/VTAM 5735-RC2 

OS/VS2 MVS Resource Measurement Facility (RMF) 5665-274 
OS/VS2 Sort/Merge - Release 5 5740-SM1 


Related Publications 


The following manuals should be available for reference while you are reading 


this SRL: 

MVS/Extended Architecture Resource Measurement Facility LC28-1138 
Version 3 Reference and User’s Guide 

MVS/Extended Architecture Message Library: System Codes GC28-1157 

MVS/Extended Architecture Message Library: System GC28-1156 
Messages 

MVS/Extended Architecture Operations: System Commands GC28-1206 

MVS/Extended Architecture Conversion Notebook GC28-1143 

MVS/Extended Architecture JCL GC28-1148 

MVS/Extended Architecture Debugging Handbook Volume I  LC28-1164 

MVS/Extended Architecture Debugging Handbook Volume 2  LC28-1165 

MVS/Extended Architecture Debugging Handbook Volume 3 LC28-1166 

MVS/Extended Architecture Debugging Handbook Volume 4  LC28-1167 

MVS/Extended Architecture Debugging Handbook Volume 5  LC28-1168 


Preface iii 


MVS/Extended Architecture System Programming Library: GC28-1149 
Initialization and Tuning 

MVS/Extended Architecture System Programming Library: SC23-0059 
JES3 Initialization and Tuning 

MVS/Extended Architecture System Programming Library: SC23-0065 
JES2 Initialization and Tuning 

MVS/Extended Architecture System Programming Library: GC28-1152 
System Modifications 

MVS/Extended Architecture System Programming Library: GC28-1150 
System Macros and Facilities Volume 

MVS/Extended Architecture System Programming Library: GC28-1151 
System Macros and Facilities Volume 2 

MVS/Extended Architecture Data Management Services GC26-4013 

MVS/Extended Architecture System Programming Library: $C23-0060 
JES3 User Modifications and Macros 





MVS/Extended Architecture Utilities GC26-4018 
MVS/Extended Architecture System Programming Library: GC28-1158 
31-Bit Addressing 


Notational Conventions 


The parameters and instructions shown in this publication use the following 
notational conventions: 


@ Bold type letters, words, and symbols: code them exactly as shown, 





e Italic type letters. words, and symbols: substitute specific information. 
@ } (blank characters): code a blank. 


e {} (braces): code only one of the items or use the default value. Do not code 
the braces. 


e | | (brackets): code any enclosed item or items — they are optional. Do not 
code the brackets but specify commas if they are included with the items 
enclosed in the brackets. 


| (OR signs): select only one of the items separated by the OR signs. 


Underscores: if you do not code a value, the underscored one is the default. 
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Summary of Amendments 


Summary of Amendments 

for GC28-1153-4 

as Updated June 1986 

for MVS/System Product Version 2 Release 1.7 


The changes in this major revision include: 


e Updates to the exit routines IEFUII and IEFACTRT found in 
Chapter 4. 


e The additions of record type 38 (26) — Network Performance 
Monitor Statistics and record type 39 — Network Logical Data 
Manager. 


e@ Record type 37 — Network Problems Determination Application, 
record type 79 — Monitor II Activity are updated. 


e Updates to figures 10-3 (EFUJI — Job Initiation Exit and IEFUSI — 
Step Initiation Exit) and 10-9 TEFACTRT — Termination Exit). 


In addition, other minor technical and editorial changes have been 
made. 


Summary of Amendments 

for GC28-1153-3 

as Updated January 16, 1986 

by Technical Newsletter GN28-1095 


This Technical Newsletter, which supports MVS/System Product Version 2 
Release 1.3, consists of: 


e@ Updates to record type 21 (15) — Error Statics by Volume. 
e The addition of record type 102 (66) — DATABASE 2 Performance. 
e Additions to Chapter 7 “‘Field-to-Record-Cross-Reference”’ 


Summary of Amendments 
for GC28-1153-3 


as Updated January 3, 1986 
by Technical Newsletter GN28-1094 


This Technical Newsletter contains changes to support MVS/System Product 
Version 2 Release 1.3 Vector Facility Enhancement. The changes include: 


e Changes to record type 22. 
e Additions to record type 30, and record type 70. 


e Additions to Chapter 7 “Field-to-Record Cross-Reference” and to Chapter 9 
“CPU Time.” 
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Chapter 1: Introduction 


SMF (System Management Facilities) collects and records a variety of system and 
job-related information. SMF formats the information into a number of different 
records. System-related SMF records include information about the configuration, 
paging activity, and workload; job-related records include information on the CPU 
time, SYSOUT activity, and data set activity of each job step, job, and TSO session. 


By creating analysis and report routines, installations can use the information in 
SMF records in many ways. For example, the collected information is useful in 
producing reports for billing users, for analyzing the workload, or for profiling 
system resource usage. 


SMF runs in its own address space (SMF). Because the SMF address space 
contains the SMF control blocks and buffers, an installation can restart SMF. If 
SMF fails, an installation does not have to re-IPL to regain SMF recording capabili- 
ties. The SET command can be used to restart SMF. An IPL might be necessary to 
restart SMF if the system management facilities control area (SMCA) has been 
destroyed. 


SMF also provides exits that allow installations to add routines to the control 
program to perform additional processing. User-written routines at SMF exits 
receive control at different times during a job’s flow through the system. They also 
receive control when specific events occur, such as when a job CPU-time limit 
expires. These user-written routines could collect additional information, cancel 
jobs, or enforce installation standards. 


Because SMF data-collection routines and exit routines are independent of each 
other, they can be used in combination or separately. For example, by analyzing 
the information SMF data-collection routines obtain, an installation can set a time 
limit for all jobs running on the system. Any job exceeding this limit is auto- 
matically terminated. However, if an installation would like certain jobs to exceed 
the time limit, a routine can be added at the SMF time limit exit, IEFUTL. This 
exit routine could then extend the time limit for selected jobs. 


SMF Overview 


Figure 1-1 and its associated paragraphs provide an overview of SMF. The use of 
SMF will vary from installation to installation according to: (1) the SMF 
parameters selected, (2) the exit routines added, and (3) the analysis/report 
routines used to summarize the collected data. 
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Figure 1-1. SMF Overview 
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Most system components contain routines that provide data to SMF. Some system 
routines (such as timer supervisor routines) collect a single data item and 
accumulante the value of the item in an SMF control block. Other routines build 
a record of various data items and use SVC 83 to eventually transfer the record to 
the SMF data set. 


For information on: (1) the system routines that interface with SMF to write 
records, (2) the specific events that cause SMF to write records, and (3) the 
contents of each record, see the chapter “SMF Records’’. To locate a specific 
system or job-related data item, use Chapter 7, the “Field-to-Record Cross- 
Reference”, which alphabetically lists all the data items (or ‘fields’) in the 
SMF records. 


In addition to collecting data for SMF, some system routines interface with 
the SMF exits. These system routines pass control to the SMF exits at 
several points during job and job step processing. They also pass control to 
the SMF exits when specific events occur, such as when the output limit of a 
data set is exceeded. For a description of the interface between these system 
routines and the SMF exits, see the chapter “User-Written Exit Routines”. 


An installation can include routines for any or all of the SMF exits. These 
user-written routines could: 


e Enforce installation standards for resource requests, accounting fields, 
and naming conventions 


e Supply defaults for missing or incorrect parameters to avoid unnecessary 
job termination 

e Collect installation-dependent job information and write it to the SMF 
data set for further analysis 


Several programming facilities are available for user-written exit routines. 
These facilities, such as the common exit parameter area and the SMFWIM 
macro instruction for writing to the SMF data sets, are common to most exit 
routines. The chapter “User-Written Exit Routines” describes the 
programming facilities that SMF provides. That chapter also lists 
programming restrictions that apply to the exit routines, mentions several 
sample routines, and shows a procedure for testing the exit routines. For 
information on adding the user-written routines to the control program, see 
“Including User-Written Exit Routines in the Operating System” in the chapter 
“System Requirements and Considerations”. 


SMF routines: 
e Collect and format data from job, system, and SMF control blocks 


e Build SMF data management records such as the SMF dump header and 
trailer records 


e Transfer records from the SMF buffer to the SMF data sets 


e@ Issue messages to the operator indicating the successful or unsuccessful 
completion of specific SMF-related events 
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The chapter “System Requirements and Considerations” lists the SMF 
storage requirements and several SMF performance considerations. 


An installation can vary the amount of information SMF routines collect and 
record by using several SMF parameters. The chapter ““Defining the Use of 
SMF” describes the formats, uses, and default values of these parameters. 


There are many SMF data sets; each data set must be named SYS1 .MANn, 
where n can be A through Z or 0 through 9. These data sets are filled alter- 
nately: while the SMF writer records on one data set, the others can be written 
out (or cleared). As long as one inactive data set is empty when the active data 
set becomes full, the SMF writer continues to record. 


At system initialization time, the first data set specified in the DSNAME para- 
meter of the SMFPRMxx parmlib member is used as the active recording data 
set unless it is full. SMF checks each data set in the order it is listed until it 
finds one that is not full. SMF then uses this data set and requests that the 
operator dump all data sets that are not empty. 


At SET SMF time, recording continues on the active data set unless the active 
data set was omitted from the new options. In that case, a switch is made to the 
first empty data set. For more information on the SET SMF command, see 
“Using the SET Command”’. 


For additional information on allocating, dumping, and switching the data 
sets, see the chapter “System Requirements and Considerations’. 


User-written analysis and report routines process the information recorded by 
SMF. Analysis routines could read the SMF data set, list the dumped SMF 
data set, use a sort/merge program to order the SMF-recorded information, or 
perform a detailed investigation of one particular SMF data item such as “job 
CPU time under TCBs”. Report routines usually format and print the 
Statistics and/or results of the analysis routines. For a description of sort/ 
merge routines and a sample report program, see the chapter “User-Written 
Report Programs.” For examples and suggestions on creating reports from 
SMF data, see the following section, “Uses of SMF Data”. 


Uses of SMF Data 


The volume and variety of information in the SMF records enables installations to 
produce many types of analyses and summarizations. For example, by keeping 
historical SMF data and studying its trends, an installation can evaluate changes in 
the configuration, workload, or job scheduling procedures. Similarly, an installation 
can use SMF data to determine the amount of system resources that are wasted 
because of poor operational procedures or programming conventions. 
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The following examples illustrate the types of reports that can be created from 
SMF data. The examples should be viewed primarily as suggestions to assist you in 
beginning SMF analyses and reports in the areas of: 


e Billing users 

Reporting reliability 

Analyzing the configuration 

Scheduling jobs 

Summarizing direct access volume activity 
Evaluating data set activity 


Profiling system resource utilization 


For example the Service Level Reporter (5668-966) can be used to report on 
reliability, scheduling jobs, and profile system resource utilization. 


Billing Users 


SMF reports a great deal of data that installations can use as a basis for billing 
algorithms and reports. The following sample procedure briefly summarizes one 
approach installations might follow in creating billing algorithms and reports from 
SMF data: 


1. Establish the primary goal(s) that the installation wants to achieve from billing 
its users for computer services. 


2. Break down these goals into specific billing objectives. 


3. Review the SMF-recorded data items (listed in Chapter 7) to determine the 
data items that best satisfy the installation’s billing objectives. 


4. Create billing algorithms using the appropriate SMF-recorded data items. 


5. Generate billing reports for the installation’s users (or for management review). 


The examples that follow illustrate how different installations might implement 
this procedure. 


Example I. An installation whose primary goal is to recover its total cost 
(personnel, equipment, supplies, etc.) might set the following billing objectives: 


@ The billing algorithms and reports must not require expensive programming to 
control. 
e@ The users must easily understand the the charges. 


e@ The charges must be repeatable, that is, the charge for a job must be the same 
each time the job is run. 


Given these objectives, the installation might want to create a billing algorithm 
that is based on one specific SMF-recorded data item such as the “step CPU time 
under TCBs”, “number of cards read/punched”, or “number of lines/pages 
printed”’. 
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Example 2. An installation that has a limited variety of computer applications 
might have the following billing objectives: 





e The charges must accurately represent the amount of time required for each 
application. 


e The charges must be consistent for the same types of applications. (For 
example, all payroll applications must have the same base cost.) 


To fullfill these objectives, such an installation might take the following steps in 
creating its billing algorithms: 


1. Using SMF, establish an average-run time (through actual running or simulation) 
for each type of computer application. 


2. Estimate the average-run-time cost for each type of application. 
3. Set a cost-per-hour rate (using steps 1 and 2 above). 


4. Multiply this rate times the “job elapsed time” recorded by SMF for each 
application. 


Example 3. An installation that is operating at or near full system capacity might 
want to encourage better use of its limited resources through billing. The major 
billing objectives of such an installation might include: 


e The users must only pay for the system resources they use. 
e The rates for abundant resources must be lower than the rates for scarce ones. 


e The charges for each system resource must fluctuate with the demand for that 
resource. 





Assuming that it has cost-conscious users, the installation might use degradation 
and/or efficiency billing, as described later in this section, to satisfy these 
objectives. 


Example 4. An installation where the use of TSO is heavy might set these 
specific objectives: 


e TSO billing must be understandable to its users in the terms of the work they do. 


e The billing must be predictable; TSO users should be able to estimate the charge 
for a given terminal session. 


e The billing must recover TSO costs. 


The installation can use transaction billing, as described later in this section, to 
satisfy these objectives. 


Note: To use transaction billing for TSO commands, you must have installed MVS 
| TSO Extensions (5665-285). 
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Degradation Billing 


Installations can use degradation billing to enforce standards that were created to 
balance system resource usage. Degradation billing allows a user to process his job 
even though he has violated a specified resource-usage standard. However, because 

of the standard violation, the installation will charge the user an additional “punitive” 
cost for his job. For example, one installation standard might state that a single 

job step should not allocate more than six tape units out of the system’s available 
ten. Hence, for each of the first six tape units allocated, the installation will 

charge a base cost; however, for each unit allocated over the allowed six, it might 
charge a progressively increasing cost. 


Another installation standard might state that programs using the 
ADDRSPC=REAL facility should not allocate more than 100K bytes, and that 
any program allocating more than 300K bytes is not only violating the standard 
but is totally degrading the system. This installation might charge its users for 
ADDRSPC=REAL storage by establishing a price per K-storage hour used as 
follows (illustrated in Figure 1-2): 


e For an allocation of 100K bytes or less, the charge is a minimum base cost per 
K-storage hour. 


e For an allocation greater than 100K bytes but less than the critical level of 300K 
bytes, the charge is a higher base cost per K-storage hour plus a small “punitive” 
cost based on hour of tie-up. 


e For an allocation of 300K bytes or more, the charge is a very large “punitive”’ 
cost based on hour of tie-up. 
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Figure 1-2. Sample Degradation Billing for ADDRSPC=REAL Storage 


Efficiency Billing 


Efficiency billing is very similar to degradation billing in that it encourages 
conservative use of system resources. Efficiency billing, however, reduces the 
charge for those who use the system efficiently. For example, by evaluating the 
“date” information in each SMF job initiation record, an installation might charge 
less for those jobs submitted for Sunday or holiday processing. Likewise, an 
installation might use the SMF-recorded “time” information to charge less for jobs 
started during the second or third shifts. Another example of efficiency billing is to 
give special reduced rates for jobs that represent low-priority background work. 
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Transaction Billing 


Note: To use transaction billing for TSO commands, you must have installed MVS 
TSO Extensions for MVS/XA (5665-293). 


Transaction billing charges for work in units that are meaningful to the user. Trans- 
action units can include executions of a particular program, online invocations of a 
defined function, or records read or printed by a standard application. Also, bills 
based on transaction units show a clear relationship between the service requested 
and the payment due, a relationship that, for TSO and IMS, is not apparent from a 
list of resources actually consumed. Techniques of specifying storage allocation, 
for instance, are not visible to many terminal users, who therefore have trouble 
relating their actions to a charge for storage hours. However, charging in terms of 
commands used is clear to the terminal user. 


Transaction billing enables the users, who see the correlation between what they 
do and what they pay, to develop cost-effective operating standards. If transaction 
prices incorporate the average cost of resources consumed, the users can evaluate 
alternatives and make rational decisions in the framework of their own operations. 


Example 4 suggests billing for the use of some TSO commands. To be suitable as 
a billing unit, a transaction should involve processing costs that are consistent enough 
over a period of time to be meaningfully averaged. The transactional billing data 
collected for TSO is the number of each TSO command issued. A TSO command does 
not relate to the system resources manager (SRM) definition of a TSO transaction as 
described in Jnitialization and Tuning. The following steps can be used to develop 
a method of transaction billing, as described in example 4. 


1. Determine the TSO costs to be recovered. To determine the TSO cost, summarize 
the total installation cost and then allocate part of it to TSO. You can obtain a 
gross allocation ratio from the data in type 30 records by comparing the resource 
consumption for TSO with the overall resource consumption. 


2. For each type of TSO command, measure the average resource consumption and 
the number of times the command is used over a representative time period. You 
can obtain this data from type 32 records with the DETAIL option. For further 
discrimination, all calculations could be further broken down by specific user-id. 


3. Based on the number of commands issued (obtained during step 2) and any other 
relevant information, predict the command use by type for a billing period. 


4. Set rates for the resources measured in type 32 records, so that the use predicted 
in step 3 recovers the TSO costs from step one. That is, the resources used multi- 
plied by the rates set for the resources should equal the cost to be recovered. 


5. Set prices for each type of TSO command, based on the use of the command as 
determined in step 2, at the rates established in step 4. That is, divide the cost 
of the resources by the number of times the command was issued to determine 
the price for each command type. 


6. For the duration of each billing period, count the commands being issued by type 
and user-id from the data in the type 32 record. Use the prices determined in step 
5 to bill each user-id for the commands used. 


7. Repeat step 6 for each billing period until the prices must be recalculated. (De- 
ciding how often to recalculate the prices represents a trade off between accuracy 
and stability.) If costs have changed, start with step 1, otherwise start with step 2. 
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Reporting Reliability 





The examples that follow describe a few ways of using SMF to report the 
reliability of the system. 


Approximate System Availability — SMF produces records at IPL time and when 
the operator enters a HALT EOD command preceding the scheduled shutdown of 

the system. By examining these records and the last SMF record recorded prior to 
shutdown of the system, an installation can establish the following for a given time 
period: 

e Reporting interval 

e Number of IPLs 

e System up time and system down time 

0 


Number of scheduled stoppages and the approximate amount of scheduled down 
time 

@ Number of unscheduled stoppages and the approximate amount of unscheduled 
down time 


@ Reason for system failure 


@ Operator’s name 


In addition, JES2 and JES3 produce the SMF subsystem start (type 43) and sub- 
system stop (type 45) records. From these records, an installation can further 
analyze the system’s availability by checking the start times, stop times, and 
circumstances under which JES2 or JES3 was started (for example, a cold start 
versus a warm start). 





Abend Code Summary — SMF reports a system or user abend code for each job 
and job step that abends. By tracking those codes issued as a result of operational 
procedures (such as codes 122 and 222 for operator cancels), an installation can 
account for any loss of CPU time due to job reruns. More generally, a summary of 
the abend codes by program name or code allows an installation to determine 
which programs are abending frequently and which codes are occurring most often. 
This might show the need for software error corrections, JCL revisions, or better 
Operating instructions. 


Direct Access VTOC Errors — The SMF record type 19 has a “VTOC indicator” 
bit that is set if the system fails while a VTOC is being updated. By checking the 
setting of this bit, operations personnel can identify any VTOCs that might have 
missing tracks or overlapping data sets. 


Tape Error Statistics — The SMF type 21 records provide tape error statistics such 
as the number of temporary read and write errors, permanent read and write errors, 
noise blocks, erase gaps, and cleaner actions. By sorting and summarizing these 
error statistics by tape volume (or tape unit), operations personnel can identify 
volumes that might need reconditioning or replacement, or point out tape drives 
that might require cleaning or maintenance. 





1-10 System Management Facilities (SMF) 


Analyzing the Configuration 


SMF generates records describing changes in the system configuration: 
e At IPL for online devices and MSS units (types 0, 8, 19, and 22) 

@ When a device is added to the configuration (type 9) 

@ When a device is removed from the configuration (type 11) 


@ When a CPU, channel path, storage, or MSS device moves online or offline 


(type 22) 


In addition to these records, operations management can use specific information in 
other SMF records to report configuration statistics. The examples that follow 
show this use of SMF. 


Device and Channel Loading — From SMF records, an installation can obtain the 
total problem program EXCP counts by device and by channel over a given 
reporting period. (See Chapter 8 for a detailed explanation of EXCP counts and 
the SMF record types that record them.) While this summary does not provide a 
true picture of the I/O load distribution, it might be helpful in identifying a gross 
loading imbalance among various devices or channels. 


Concurrent Device Usage — An installation can combine the data in the SMF step 
termination records to report the number of devices per device type that problem 
programs used during specified intervals. By using this report with the device 
activity records (type 74), an installation can identify periods of the day when the 
percentage of problem-program device usage was exceptionally high or low. 
Further evaluation might also show the cause of concurrent device usage. If, for 
example, no more than 12 of the available 16 tape drives are ever in use at the same 
time, any of the following situations might be responsible: 


e@ Job classes are conflicting. 


e Too few initiators are started. 


Scheduling Jobs 


Through the use of SMF data, it is possible to identify specific intervals when the 
problem program use of system resources is at an extremely high or low level. By 
studying the trends in this SMF data, and the relationships among the trends, 
operations management can establish and enforce its job scheduling procedures. 
The following examples describe a few potentially useful SMF data-trend analyses 
for scheduling jobs. 


Concurrent Job Activity — The SMF job initiation and termination records 

contain the start and stop times of each batch job, job step, TSO session, and started 
task. Using these times, an installation can determine the jobs that are executing 
during the same interval. From a scheduling point of view, a low number of 
concurrent jobs might indicate the need for establishing more job classes or using 
more initiators. 
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Job Wait Time in Initiation and SYSIN/SYSOUT Queues — The SMF step J 
termination records have the following three time stamps: step initiation time, 

device allocation start time, and problem program start time. By calculating the 

differences in these three times, an installation can identify any abnormally long 

job step initiation. 


In addition, an installation can use the SMF output writer and job purge records 
to track job wait times in both the SYSIN and SYSOUT queues over a given period 
of time. If the resulting pattern of wait times shows any significant variances, the 
installation might want to further investigate the problem areas and perhaps 
alleviate them by rescheduling manpower or changing hardware. 


Job Throughput and Turnaround Time — By examining the SMF-recorded job 
accounting fields (such as department number, project number, and userid), as 
well as the SMF-recorded job initiation time and date fields, an installation can 
create a fairly accurate picture of its job throughput and turnaround time. For 
instance, one installation might analyze its throughput by calculating the total 
number of jobs initiated within each 15 minute interval and categorizing its jobs 
into test and production jobs. 


Such an installation could also use SMF to determine the time of day when the 
largest number of production jobs were going through the system. By then limiting 
the number of test jobs during that time, the installation might improve its produc- 
tion tumaround time. 





Workload Characteristics — SMF provides job and job step information such as: 
Job/step name 

CPU time 

Elapsed (turnaround) time 

Address space dispatching priority 

JES2/JES3 job selection priority 

JES3 deadline type 


Service units 


Performance group number 


By summarizing this type of SMF information for all jobs and job steps over a given 
period of time, an installation can establish its workload characteristics and set 
specific standards for each job class and priority. An installation can also use this 
information to determine whether its service goals are being met for specific 
combinations of job class, priority, performance group, and JES3 deadline type. 
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Summarizing Direct Access Volume Activity 


SMF reports a great deal of information about problem-program use of direct 
access volumes. The examples that follow illustrate how operations personnel can 
use this SMF information to examine problem-program use of direct access storage. 


Allocated But Unused Direct Access Storage — Many times users make allocation 
requests for direct access storage that are far in excess of the actual requirement. 
This misuse can be a significant drain on the direct access resource pool. In order 
to determine the number of tracks that were allocated for sequential data sets but 
were not used, an installation can compare the following two fields in the SMF type 
15 records: 


@ The relative track of the last record written (in the DASD extension of the 
DCB/DEB section) 


e The total number of tracks allocated (in the DASD extension of the UCB 
section) 


Volume Mounting — SMF writes a type 19 record whenever a volume that is 
defined by a DD statement is demounted. By summarizing these records by 
volume, an installation can obtain some indication of its direct access volume 
mounting activity for problem programs. 


In addition, an installation can use the SMF type 25 records to summarize the 
JES3 volume mounting for problem programs. (JES3 produces a type 25 record 
for each job that main device scheduling (MDS) processes.) These records show 
both the number of tape volumes and the number of disk volumes mounted for a 
job. 


Fragmented Volumes — Periodic analysis of the type 19 records can be useful in 
identifying direct access volumes whose unallocated space is fragmented. An 
installation can identify the volumes that might need reorganization by examining 
the relationship of the following SMF fields: 


e The number of unallocated cylinders and tracks 
e The number of cylinders and tracks in the largest unallocated extent 


@ The number of unallocated extents 


An installation can further analyze the unallocated space on direct access 
volumes by comparing the number of unallocated tracks with the number of 
available DSCBs. For example, such a comparison might show that even though a 
given volume still has SO free tracks, its amount of additional space is limited 
because there is only one available DSCB. 
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Evaluating Data Set Activity 





SMF produces several records that contain information on data set activity (such 
as types 4, 14, 15, 17, 18, and 34). These SMF records can assist an installation 
in answering questions such as: 


What is the average data set size for both tape and direct access devices ? 

Is the number of multi-volume data sets significantly large ? 

What percentage of all data sets is permanent ? What percentage is temporary ? 
What percentage of all temporary data sets does VIO control ? 

Which data sets do problem programs use most frequently ? 

How often do problem programs reuse permenent data sets ? 


What is the average blocksize, block count, and EXCP count for each tape 
data set ? 


@ How are problem programs using chained scheduling ? 


The following examples show different ways of evaluating problem-program data 
set activity from SMF records. 


Multiple Extents — By checking the “number of extents” field in the UCB section 
of the SMF type 14 and 15 records, an installation can identify direct access data 
sets that have exceeded their primary allocation and have used secondary 
allocation. Although useful, secondary allocation might affect system performance 
as well as fragment the space on direct access volumes. Thus, an installation 
detecting a significant amount of secondary allocation activity might want to 
consider using VIO. 





Data Set Modifications — SMF generates a record each time a user: 
Scratches a non-VSAM data set (type 17) 

Renames a non-VSAM data set (type 18) 

Defines an Integrated Catalog Facility (ICF) catalog entry (type 61) 
Deletes an Integrated Catalog Facility (ICF) catalog entry (type 65) 
Alters or renames an Integrated Catalog Facility catalog entry (type 66) 
Defines or alters a VSAM catalog entry (type 63) 

Deletes a VSAM catalog entry (type 67) 

e@ Renames a VSAM catalog entry (type 68) 


By sorting these records by job name or userid, an installation can produce a 
report of the data sets that were defined, modified, or deleted by problem 
programs during a specified interval. Such a report might be useful in a backup 
situation, especially when critical data sets have been unintentionally altered or 
destroyed. 


Open/Close Activity — SMF writes a type 14 or 15 record whenever a data set is 
closed or processed by EOV. An installation can determine how many of these 
SMF record types were written for a given data set. The number of type 14 and 
15 records can then be used to represent the number of times that the data set 
was closed or processed by EOV. (For this kind of report, an installation might 
want to exclude any SMF records for programs such as sorts, where it is known 
in advance that the open/close activity is significant.) 
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Blocking Factors — By examining the “blocksize” and “logical record length” 
fields recorded in the SMF type 14 and 15 records, an installation can identify 
those data sets that the system is processing with ineffective blocking factors. 

For instance, assume a data set having 10,000 records is processed unblocked with 
a logical record length of 80 using a 2314 device. An installation discovering such 
a data set through SMF might increase its blocksize to 1680 (21 records) to 
minimize I/O processing overhead and reduce direct access storage requirements. 


Optional Services — Although useful, some optional services might hinder system 
performance if not used appropmiately. For example, the write validity check 
(OPTCD=W) service requires an additional disk rotation to reread the data written 
for each output block. Similarly, a data set that over uses the chained scheduling 
(OPTCD=C) service might monopolize the available time on a channel. An 
installation can use the SMF type 14 and 15 records to ensure that each 
application that uses an optional service is authorized or justified in using it. 


Profiling System Resource Usage 


Ail SMF records contain general identification fields such as the job name, step 
name, programmer name, reader start time, and reader start date. By sorting and 
summarizing SMF data according to these types of fields, an installation can create 
reports or profiles that show each batch job, job step, and TSO session’s use of 
system resources such as: 


e CPU time 
Storage 

Paging facilities 
I/O devices 


Service units 


e Programming languages 


CPU Time Usage — SMF accumulates the job/step CPU time in two separate fields 
of each job/step termination record: execution time under TCBs and execution 
time under SRBs. (See Chapter 9 for a list of the different times that are 

included and those that are excluded for these CPU-time fields.) An installation 
might want to summarize these time fields by program name over a given interval 
to compare each program’s SRB time with its total CPU time. This might identify 
programs that have excessive interrupt processing. 
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In addition to CPU time, SMF reports many different times relating to job, job 
step, and TSO session processing. For example, SMF records the following time 
Statistics: 


e@ Job/step/TSO session start and stop times 





Job/step/TSO session elapsed (turnaround) time 
Device allocation start time 

Problem program start time 

Initiator selection time 

TSO logon enqueue time 

Reader start and stop times 

Converter start and stop times 


Execution processor start and stop times 


Output processor start and stop times 


By examining these SMF-recorded time fields, an installation can profile each job’s 
flow through the system. Such a profile might identify jobs that have abnormally 
long wait times. These jobs are usually good candidates for further detailed 
examination. An installation might also want to use these time fields to determine 
which jobs are running on the system at the same time or what the average tum- 
around time is for all TSO sessions. 


Storage Usage and Paging Activity — The SMF paging activity record (type 71) 
contains information about the demands made on the system paging facilities and 
the use of real and auxiliary storage. This record is written for specified measure- 
ment intervals and includes information such as the number of: 





Non-VIO page-ins and page-outs 
Non-VIO page reclaims 
Swap-ins and swap-outs 

Address space swap sequences 


VIO page-ins and page-outs 


VIO page reclaims 


An installation can calculate the system paging rate for each specified interval by 
dividing the number of page-ins and page-outs by the interval’s CPU time. By then 
plotting several paging rates over a long period of time, an installation can develop a 
correlation between its workload and real storage capacity. 
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SMF also reports the following information on storage usage and paging activity 
for each job step and TSO session: 


e Amount of contiguous real storage reserved for a program specifying 
ADDRSPC=REAL 


e Storage used from the top of the private area (includes the LSQA and the SWA) 


Storage used from the bottom of the private area (includes subpools 0-127, 
251, and 252) 


Number of non-VIO page-ins and page-outs 


Number of swap-ins and swap-outs 


Number of address space swap sequences 


Number of VIO page-ins ‘and page-outs 


An installation can use the SMF field “storage used from the bottom of the 
private area”’, along with the paging statistics for the address space, to estimate a 
job’s use of real storage, 


I/O Activity — Several SMF records contain useful information about a job, job 
step, or TSO session’s I/O activity. For example, the step termination records 
contain device entries that include the device class, unit type, channel/unit address, 
and EXCP count. An installation might want to use these SMF fields to isolate 
those job steps whose I/O activity exceeded certain limits, for example: 


@ More than a given percentage of the I/O activity was on a certain unit. 
e More than a given percentage of the I/O activity was on a certain >hannel path. 


e@ More than a given number of data sets on the same direct access volume each 
had a significantly large number of EXCPs. 


Service Activity — An installation can use the SMF termination records to report 
the number of service units, transaction active time, and performance group 
number for each job step and TSO session. By comparing this information with the 
information reported in the RMF workload records (type 72), an installation can 
calculate the percentage of the total system services that is given to particular 
performance groups. Such a comparison might be helpful in determining whether 
service is being distributed according to the goals of the installation. (See 
Initialization and Tuning for more information on service, transaction active time, 
and performance group numbers.) 


Programming Language Usage — The SMF type 4, 30, and 34 records contain 
the name of the program used (taken from the PGM= parameter on the EXEC 
statement). By sorting these records by program name, an installation can 
determine to what extent users are compiling in various programming languages, 
such as PL/1, COBOL, and FORTRAN. 


Similarly , an installation can produce reports for specific job categories or 
installation departments by using key program names such as SORTJOBS, 
PAYROLL, and STANDRDS. By assigning unique step names (using the ACCT= 
parameter on the EXEC statement) and evaluating the SMF step termination 
records (which report those names), an installation can also produce reports for 
each step in a cataloged procedure. 
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Chapter 2: System Requirements and Considerations 


To record SMF data, an installation must define how it will use SMF (see the chapter 
“Defining the Use of SMF’’), add user-written exit routines to the control program, 
allocate direct access space for the SMF data sets, and catalog the SMF data sets. 
This chapter describes these requirements as well as SMF storage requirements and 
performance considerations. 


Including User-Written Exit Routines In The Operating System 


User-written exit routines are optional — SMF automatically provides dummy 
routines for all unused SMF exits. To include user-written exit routines in the 
operating system, you can add them to the appropriate distribution libraries before 
SYSGEN, or link-edit them into their load modules in SYS1.LPALIB after 
SYSGEN. When link-edited after SYSGEN, the modules are not available for 

use until the next IPL with the CLPA option. 


Figure 2-1 shows the distribution libraries to use to add exit routines prior to 
SYSGEN. It also shows the load module assignments to use to add exit routines 
after SYSGEN. When adding exit routines after SYSGEN, refer to your SYSGEN 
listing for exact load module names, aliases, link-edit control statements, and link- 
edit parameters. Specify link-edit parameters according to the characteristics of the 
user-written exit routines. 


Distribution Library Load Module Assignment 

for Adding User- for Adding User-Written Exit 

Written Exit Routine Routine to SYS1.LPALIB 
Descriptive Name | before SYSGEN?1 after SYSGEN 


IEFU83 SVC Entry SYS1.AQ0S00 ([EFU83 
SMF Record 

IEFU84 Branch Entry SYS1.AQS00 1EFU84 
SMF Record 


L\EFACTRT SYS1.AOSB3 | | eFACTRT 


|EFUJP SYS1.ALPALIB EF UMP 
IEFU29 /SMF Dump SYS1.A0S00 [EFU29 


1 User-written exit routines to be added before SYSGEN must be in load module format. 

















Figure 2-1. Including User-Written Exit Routines in the Operating System 
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Figure 2-2 shows sample JCL for adding user-written exit routines to " 
SYS1.LPALIB after SYSGEN. Note that when user-written exit routines become Jd 
part of SYS!.LPALIB they do not become active until the next IPL of the system 

that includes the CLPA option. 








Note: Refer to your SYSGEN listing for exact load module names, aliases, link- 
edit control statements, and link-edit parameters. Specify link-edit parameters 
according to the characteristics of the user-written exit routines. 


//LINKEXIT JOB MSGLEVEL=] 

//STEP1 EXEC PGM=IEWL,PARM='‘link-edit parameters’ 
//SYSPRINT DD SYSOUT=A 

//SYSLMOD DD DISP=(OLD,KEEP),DSN=SYS1.LPALIB 





//SYSUT1 DD UNIT=SYSDA,DISP=(,DELETE), 
SPACEXTRK,(20,5)) 
//SYSLIN DD * 
(IEFUJV object deck) 
ENTRY IEFUJV 
NAME IEFUJV(R) 
(IEF ACTRT object deck) 
INCLUDE SYSLMOD(IEFACTRT) 
ENTRY IEFACTRT 
NAME IEFACTRT(R) 
(IEFUJI object deck) 
ENTRY IEFUJI 
NAME IEFUJI(R) 
(IEFUSI object deck) 
ENTRY IEFUSI 
NAME JIEFUSI(R) 
(IEFUTL object deck) 
ENTRY IEFUTL 
NAME IEFUTL(R) 
(IEFU84 object deck) 
ENTRY IEFU84 
NAME IEFU84(R) 
(IEFUSO object deck) 
ENTRY IEFUSO 
NAME IEFUSO(R) 
(IEFU83 object deck) 
ENTRY JEFU83 
NAME IEFU83(R) 
(IEFUJP object deck) 
ENTRY JEFUJP 
NAME IEFUJP(R) 
/* 








Figure 2-2. Sample JCL for Adding User-Written Exit Routines to SYS1.LPALIB after SYSGEN 


2-2 System Management Facilities (SMF) 


SMF Buffers 


Each buffer consists of 4096 bytes plus 24 additional bytes of buffer control 
information that is not written to the data set. The number of buffers available is 
limited only by the amount of virtual storage in the SMF address space below 16 
megabytes. At initialization, SMF obtains 10 permanent and 100 temporary buffers. 
SMF obtains and releases more buffers as SMF activity increases and decreases in 
order to keep real storage use to a minimum. 


SMF Data Sets 


You can allocate space for up to 36 SMF data sets. These data sets should be 


password or RACF protected. The space must be allocated using the 
DEFINE access methods services utility or at system generation time using the 
DATASET macro instruction. 


The primary data set is the data set normally used for SMF recording; the 
secondary data sets are used when the primary one is full. The SMF data set sel- 
ection algorithms expect the primary data set to be allocated ona high performance 
device and the secondary data sets to be allocated where space is available. Primary 
and secondary data sets are designated using the DSNAME parameter in 
SMFPRMxx, where the first data set specified is the primary and all others are 
secondary. Each data set must be a VSAM data set that resides on a single volume 
and is cataloged and not extendable; do not specify secondary allocations for 
RECORDS, TRACKS, or CYLINDERS. 


SMF data sets allocated with the DEFINE utility require the following options: 


e Reuse (RUS) indicates that the data set can be cleared by the dump program. 


e Control interval size (CISZ) indicates the size of the SMF buffer. (This value 
must be 4096). 


e Record size (RECSZ) indicates the average and maximum logical record size. 
(This value must be 4086 32767). 


e Share options (SHR) indicates that sharing occurs with reading and serialization 
occurs with writing. (This value must be 2). 


e Non-indexed (NIXD) indicates that the entries are entry sequenced. 

e Spanned (SPND) indicates that the records can span control intervals. 

e@ Speed (SPEED) indicates that the dataset will not be preformatted by VSAM 
while IFASMFDP is preformatting. 


For more information on the DEFINE utility see Access Method Services. Several 
factors, such as specific system configuration, amount of SMF data to be written, 


and report program requirements, will determine which device type is most efficient 
for a particular installation. 


Note: If DB2 Performance, Serviceability, or Audit Data is sent to SMF, CIS2 


(4096) and BUFSP (81920) must be specified for each SMF VSAM Dataset on 
MVS/XA. 
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Figure 2-3 illustrates the JCL statements needed to use the DEFINE utility to 
allocate one SMF data set on a direct access device and catalog it in the system 
catalog. This figure assumes that the VSAM data space already exists and that 
an IPL with the NOACTIVE SMF parameter was performed. Each SMF data set 
must be created according to this example before the first IPL that starts SMF 
recording. The second step in this example preformats the data set. If the pre- 
formatting is not done during the definition process, SMF initialization preformats 
the data set. In either case, SMF preformats the data set with dummy records. 

To avoid increasing the time required to IPL the system, it is recommended that the 
installation use the SMF dump program, IFASMFDP, to preformat the data sets. 
When the SMF dump program dumps the data set at a later time, it does not read 
to the physical end of file on a partially full data set. SMF recognizes the first 
dummy record and terminates processing. 








//CREATE JOB 

/ICREATE EXEC PGM=IDCAMS 

/ISYSPRINT DD SYSOUT=A 

//SYSIN DD * 

DEFINE CLUSTER (NAME (SYS1.MANX) 

VOLUME (xxxxxx) 
NONINDEXED 
CYLINDERS(nn) 
REUSE 
RECORDSIZE(4086,32767) 
SPANNED 
SPEED 
CONTROLINTERVALSIZE (4096) 
SHAR EOPTIONS(2)) 


++teeteteett 





/* 

//FORMAT EXEC PGM=IFASMFDP 

//SYSPRINT DD SYSOUT=A 

//NEWDS DD DSN=SYS1.MANX,DISP=SHR 

/ISYSIN DD * 
INDD(NEWDS,OPTIONS(CLEAR)) 

/* 





Figure 2-3. Sample DD Statements for Allocating and Cataloging the SMF Data Sets 


When an SMF data set is defined at system generation time using the 
DATASET macro instruction, space is allocated and the data set is catalogued. 
However, the data set is not preformatted. 


For more information on using the DATASET macro instruction, see System 
Generation Reference. 
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Regardless of how the data sets are allocated, the amount of DASD space 
required for the SMF data sets depends on the amount of data generated and how 
often the data sets are dumped. The amount of data generated depends on the 
system work load and the record types selected for writing to the SMF data set. 
If SMF data is available from a system similar to your own, you can use the report 
produced by the SMF dump program to estimate the amount of data generated. 
Otherwise, it may be necessary to select a trial size for the data sets and adjust it 
as necessary. 


For example, you might start with two SMF data sets, each allocating 25 cylin- 
ders of space on a 3330. If the data sets fill up too quickly and data is lost, you 
can allocate more space for each data set, or allocate additional data sets. If DASD 
space is severely limited in your installation, you might have to dump the data 
sets more frequently. 
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Dumping The SMF Data Sets 





When the current recording data set cannot accomodate any more records, the SMF 
writer routine automatically switches recording from the active SMF data set to an 
empty SMF data set, and passes control to the SMF dump exit, IEFU29. The 
operator is then informed that the data set needs to be dumped. (For information on 
the IEFU29 exit, see the chapter “User-Written Exit Routines.) The operator 
should use the SMF dump program, IFASMFDP, to transfer a full SMF data set to 
another data set, and to reset the status of the dumped data set to empty so that it 
can be used again for recording data. For those installations choosing to read the 
SMF data sets directly rather than using the dump program, note that the SMF 
data sets are preformatted with dummy records. A dummy record is shorter than 
any valid SMF record and is easily identified because it contains the characters 
‘SMFEOFMARK’. The SMF dump program terminates processing when it 
encounters a dummy record, thereby improving data set processing performance. 


Note that programs that access the output of the SMF dump program are required 
to specify the correct LRECL value. Failure to specify a large enough LRECL value 
might result in an 002 abend. The LRECL value must equal the length of the longest 
SMF record being created plus four bytes for the RDW. The LRECL value can be 
larger than the BLKSIZE value because the records can be segmented. 


The SMF dump program IFASMFDP, allows multiple, VSAM or QSAM data sets 
to be dumped to one or more sequential data sets on either tape or direct access 
devices. Also, IFASMFDP allows the installation to route different records to 
separate files and produce a summary activity report. This report is described later 
in “The Summary Activity Report.” 





The installation can also specify three 24-bit addressable user exit routines to 
be given control during the dump processing. These exit routines allow the user 
to examine or modify the record before it is written. When each exit is invoked, 
register 1 contains the address of a three-word parameter list (Figure 2-4). The 
first word is the address of a three-word user work area. The contents of the user 
work area are: 


word | — register 0 on entry to IFASMFDP 

word 2 — register 1 on entry to IFASMFDP 

word 3 — reserved for user. This word is initialized to zero before the first user 
exit is invoked. 


The contents of the second and third words depends on the user exit being invoked. 
The user exits are described in “The SMF Dump Options.” 


Three-word user exit parameter list 





Three-word user exit work area 


Figure 2-4. IFASMFDP Input Parameter Structure 
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The SMF dump program copies the input data sets to the output data sets. During 
the copy process, the dump program creates two SMF records and writes them to 
each output data set: a dump header (record type 2) at the beginning of the data 
set and a dump trailer (record type 3) at the end of the data set. 


The SMF dump program also writes messages, as required, to SYSOUT: 
e The operator must not clear a data set that is being filled. If the operator 
attempts to clear the active SMF data set, IFASMFDP returns a code of X‘08’ 


in register 15. The operator can, however, dump the active or alternate data set 
without clearing it. 


e If IFASMFDP is unable to open either the input or output data sets, it writes 
an error message indicating which data set was not successfully opened. 


e If all SMF data sets and the SMF buffers become full, SMF will be in a data lost 
condition (unable to record) until dumping takes place. When this condition 
occurs, the number of lost records is tracked in SMF record type 7 and the 
operator receives a message stating that data is being lost. 


Switching The SMF Data Sets 


To prepare an SMF data set for dumping before it becomes full the operator can 
use the HALT EOD and SWITCH SMF commands. (These operator commands 
are fully described in System Commands). 


When the operator issues either the HALT EOD or the SWITCH SMF command, 
the following actions occur: 


@ Atype 19 record is created for each online direct access device if a type 19 
record was specified. 


e For a SWITCH SMF command, a type 90 record is created to show the old 
and new data set names. 


@ The SMF buffer is written to the active SMF data set. 


e The SMF data sets are switched so that the operator can dump the previously 
active data set. 


Note: When switching the SMF data sets, an inactive data set cannot become 
active unless it isempty. Therefore, the operator should use the DISPLAY SMF 


command to verify that there is at least one alternate data set before issuing tlie 
HALT or SWITCH command. 


Performance Considerations 


SMF will reduce system throughput by various amounts depending upon factors 
such as: 


e SMF options selected through the SMFPRMxx parameters. (For a description 
of these parameters, see the chapter “Defining the Use of SMF’’.) 


e@ SMF data set size, device type, and dumping requirements. 


e Execution time of user-written exit routines. 
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e System configuration, especially the type and degree of multiprogramming. ) 


e Processing characteristics, such as the number of jobs (the number of records 
generated by SMF depends on the number of jobs), the contention for SMF 
resources, and user data set requirements. 


@ Specific record type chosen to be recorded. 


Note that record types can be suppressed, as described under “Defining the 
Use of SMF”’. 
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Defining the Use of the SMF Dump Program 


This section describes the SMF dump program, IFASMFDP. Included in this 
section are: 


e@ The SMF dump options 
e Executing the SMF dump program 


e The summary activity report 


The SMF Dump Options 


The IFASMFDP parameters control the processing of the dump program. The 
parameters are: 


Neanina and Ue 


INDD(ddname,OPTIONS(data)) Describes the input data set, where ddname is the DONAME of the data set and data can 
be any one of the following: 
@® DUMP indicates that the input data set is to be read or copied without being reset. 
@ CLEAR indicates that the input data set is to be reset and preformatted. 
The information on the data set is not copied and therefore lost. 
@ ALL indicates both the DUMP and CLEAR options. 


If INDD is not specified the default is: 
t{NDD(DUMPIN,OPTIONS(ALL)) 


If DUMP or ALL is specified, a summary activity report is written if at least one record 
was read or written. For more information, see ‘‘Summary Activity Report.” 









































Describes the output data set, where ddname is the DDNAME of the output data set. 
TYPE indicates that the records specified in list are to be included in the data set. 
NOTYPE indicates that all records except those specified in list are to be included in the 
data set. List can be any record or combination of records; the records can be specified 
individually or as a range. For example, TYPE(2,4:7,9,11) indicates that records 2, 4, 5, 
6, 7,9, and 11 are to be included in the data set. 


If OUTDD is not specified the default is: 
OUTDD(DUMPOUT,TYPE(000:255)) 
if both TYPE and NOTYPE are specified for the same data set, the first valid specification 


is used. If a syntax error occurs in the OUTDD option and any INDD option specified ALL 
or CLEAR, the job is terminated. 


TYPE : 
OUTDD(ddname, {rerveep ti 








DATE(yyddd,yyddd) Specifies the start and end date for the period for which records are to be written, where 
yy is the last two digits of the year and ddd is the Julian date. The value for ddd can not 
exceed 366. If only one date is requested, the start and end dates are the same. If two 


dates are specified, only those records written on or between the two dates are written. 


If DATE is not specified the default is: 
DATE(00000,99366) 





START (hhmm) Specifies that only those records that were recorded after the START time and before 


the END time are to be written, where hh is the hours and mm is the minutes, based on a 
24-hour clock. 
If START is not specified the default is: 
START(0000) 


Specifies that only those records that were recorded after the START time and before the 
END time are to be written, where hh is the hours and mm is the minutes, based on a 
24-hour clock. 


If END is not specified, the default is: 
END(2400) 
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Meaning and Uso 


ae Specifies that only records written by the operating system with the specified system 


identifier can be written to the output data set, where cccc is the system identifier. SID 
USER 1(name) 











can be specified for each system the dump program is expected to handle. If SID is not 
specified, records pertaining to any operating system are written. 





Specifies the name of a user-written exit that is given control after each record is read and 
the counters incremented. The parameter list pointed to by register 1 contains the address 
of the three-word user work area in word 1, the address of the SMF record in word 2, and 

the address of the INDD ddname in word 3. 


The user exit routine must set a return code in register 15 before passing control back to 
the dump program. The return codes are as follows: 

















Code Meaning 
00 Indicates that normal processing should continue. 
04 Indicates that the record should not be written to the output data set. 


Any other raturn code indicates that a problem was encountered and that the dump program 
is not to invoke the exit again. 














USER2(name) 


USER3(name) 


Specifies the name of the user-written exit routine that is given control only when the 
dump program selects a record to be written. The parameter list pointed to by register 1 
contains the address of the three-word user work area in word 1, the address of the SMF 
record in word 2, and the address of the OUTDD ddname in word 3. This exit is always 
called by the dump progrem before any records are read. 


The return codes are the same as those for USER1. 













Specifies the name of the user-written exit routine that is given control after the output 
data set is closed. This routine is invoked for each output data set. The paremeter list 
Pointed to by register 1 contains the address of the three-word user work arsa in word 1, 
the address of the output DCB in word 2, and the address of the QOUTDD ddname in word 
3. 


The user exit routine must set a return code in register 15 before passing control back to the 
dump progrem. The return codes for USER3 are as follows: 
O indicates that normal processing should continue. 


Any non-zero return code indicates that a problem was encountered and that the dump 
program is not to invoke the exit again. 





Notes: 

l. If a syntax error occurs in the processing of a parameter, the parameter is 
not processed and a message is printed in the SYSPRINT data set. Ifa 
parameter is not specified, the default is used. The valid dump parameters 
specified or used by default are listed in the SYSPRINT data set on com- 
pletion of the dump program. 


2. The name field in USER1, USER2, or USER3 specifies the name of a load 
module which IFASMFDP LOADs and CALLs at the indicated times. Each 
exit should be link edited into an APF-authorized library but the exit should 
not be link edited with the AC=1 attribute. 


3. If the start time is less than the end time, the records selected for any 
particular day are those records produced after the start time and before the 
end time. For example, if you specify: 


START(0800),END(2000) 
SMF selects records during the period indicated by the shaded area: 
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2400 08 


LWA 


Day 1 Day 2 Day 3 





If the start time is greater than the end time, all records produced between 
the start time and the end time on the following day are selected. For 
example, if you specify: 


START(2000),END(0800) 
SMF selects records during the time period indicated by the shaded area: 


2400 0800 2400 0800 2400 0800 2400 


Day 1 Day 2 Day 3 





Note that the records produced between 0800 hours and 2000 hours in any 
day are not selected. 


4. User records must include a standard record header; the IFASMFDP program 
might not dump or flag in error a record that does not have a standard header, 


Executing the SMF Dump Program 


Figure 2-5 shows sample JCL for executing the SMF dump program (IFASMFDP). 
The output is a non-temporary data set on a standard-labeled tape. The operator 
should record the volume serial number of the output data set so that other jobs 
can reference it. Note that it is not necessary to specify the DCB=keyword. The 
dump program assigns the following DCB attributes: 

e BLKSIZE=4096 

e LRECL=32767 


e RECFM=VBS 





/IDUMPX JOB  MSGLEVEL=1 
HISTEP1 EXEC PGM=IFASMEDP 
/IOUMPIN. DD  DSN=SYS1.MAN ed: ‘DISP=SHR 


/IOUMPOUT DD DSN=SMFDATA,UNIT=tapeaddr, 
// DISP=(NEW,KEEP),LABEL=(,SL),VOL=SER=serial 
/ISYSPRINT OD SYSOUT=A 


Figure 2-5. Sample JCL for Executing the SMF Dump Program 
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SMF data set (INDD1) and to combine its records with those in an old dumped 
file (INDD2) to two online data sets. 


Figure 2-6 illustrates a sample job using the IFASMFDP to dump and clear an ) 


There can be any number of input (INDD) or output (OUTDD) files in the 
dump program. The input files are dumped in reverse order unless concatenated 
under one input file. For example, in Figure 2-6, two input files are specified. 


After the dump program is executed, the output file contains the records from 
INDD2 first, followed by the records from INDD1. 


/IIFASMFDP JOB accounting information 


/ISTEP EXEC PGM=|FASMFDP 
//INDD1 DD DSN=SYS1.MANB,DISP=SHR 
/ANOD2 DD DSN=SMFDATA,UNIT=TAPE,DISP=SHR,VOL=SER=SMFTAP 


//OUTDD1 DD DSN=ALLSMF.TYPEO.TYPE40,DISP=SHR 
/OUTDD2 DD DSN=ALLSMF.TYPE10.TYPE255,DISP=SHR 
/ISYSPRINT DD SYSOUT=A 
IISYSIN DD * 
INDD(INDD1,OPTIONS(ALL)) 
INDD(INDD2,OPTIONS(DUMP)) 
OUTDD(OUTDD1,TYPE(0,2,10,15:40)) 
OUTDD(OUTDD2,TYPE(10:255)) 
DATE(82002,82366) 
SID(308A) 
S|D(308B) 


/* 
Figure 2-6. Sample Job for Dumping SMF Data Sets 


After the IFASMFDP job shown in Figure 2-6 executes, the following information ) 
is listed in the SYSPRINT data set. 


SMF DUMP PARAMETERS 

SID(308A) — SYSIN 

SID(308B) — SYSIN 

END(2400) — DEFAULT 

START(0000) —~ DEFAULT 

DATE(82002 82366) — SYSIN 
OUTDD(OUTDD2,TYPE(10:255)) —SYSIN 
OUTDDI(OUTDD1,TYPE(0,2,10,15:40)) — SYSIN 
INDD(INDD2,OPTIONS(DUMP)) — SYSIN 
INDD(INDD1,OPTIONS(ALL)) ~ SYSIN 


One method of executing the SMF dump program is to enter jobs that specify 
the program into the system, and hold them on the job queue until a dump is 
required. Another method is to start a reader to an input stream containing the 
JCL for the SMF dump program. Figure 2-7 illustrates two sample procedures 
(DUMPX and DUMPY) for dumping the SMF data sets to a standard-labeled tape 
(VOL=SER=SMFT AP) by means of the operator START command. In both 
procedures, the default tape specified on the PROC statement is 192. Figure 2-7 
also illustrates sample JCL for adding these procedures to SYS1.PROCLIB. 
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/IUPDATE JOB MSGLEVEL=1 

/IUPDATE EXEC PGM=IEBUPDTE,PARM=NEW 
IISYSUT1 DD DSN=SYS1.PROCLIB,DISP=SHR 
IISYSUT2 DD DSN=SYS1.PROCLIB,DISP=SHR 
/ISYSPRINT DD SYSOUT=A 

IISYSIN DD DATA 

m ADD NAME=DUMPX,LIST#ALL 
//DUMPX PROC TAPE=192 

//SMFDMP EXEC PGM=IFASMFDP 

//DUMPIN DD DSNAME=SYS1.MANX,DISP=SHR 
/IOUMPOUT DD DSNAME*SMFDATA,UNIT2=&TAPE,DISP=(MOD,KEEP), 


LL LABEL=(,SL),VOL=SER=SMFTAP 
/ISYSPRINT DD SYSOUT=A 
/ ADD NAME=DUMPY,LIST=ALL 


//DUMPY PROC TAPE=192 

//SMF DMP EXEC PGM#IFASMFDP 

//OUMPIN DD DSNAME2SYS1.MANY ,DISP=SHR 

/IDUMPOUT DD DSNAME=SMFDATA,UNIT#=&TAPE,DISP=(MOD,KEEP), 


If LABEL=(,SL), VOL=SER=SMFTAP 
HISYSPRINT DD SYSOUT=A 

./ENDUP 

/* 


Figure 2-7, Sample Procedures for Dumping the SMF Data Sets 


The CLEAR function of IFASMFDP requires APF-authorization. Executing 
the dump program as shown in the above JCL examples preserves the APF- 
authorization assigned to the program when link-edited by SYSGEN. Invoking 
IFASMFDP in any way other than as shown above (for example, invoking 
IFASMFDP from another program or invokiug it as a TSO command), might 
cause it to lose its authorization. 


The DUMP function is permitted in an unauthorized environment. If the 
CLEAR function is attempted, a message is written indicating that the request was 
denied. 


For more information on APF-authorization, see System Macros and Facilities. 
For more information on executing authorized programs under TSOQ, see TSO. 


The IFASMFDP dump utility also issues return codes. They are as follows: 
Code Meaning 


00 Indicates that the dump was successful; no errors were encountered. 

04 Indicates that the dump was successful; one or more errors were 
detected but processing continued. 

08 Indicates that the dump was not successful; an error terminated 
processing. 
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The Summary Activity Report ) 


The dump program creates a summary activity report when the DUMP option was 
specified for any of the input data sets and at least one record was read or written. 


Figure 2-8 shows an example of the summary activity report the dump program 
creates. The meaning of each heading is: 


e START DATE-TIME indicates the date and time of the earliest record read, 
excluding record types 2 and 3 and those greater than 127. 


e END DATE-TIME indicates the date and time of the latest record read, 
excluding record types 2 and 3, and those greater than 127. 


@e RECORD TYPE indicates the identifying number of each record type read by 
the dump program. 


@e RECORDS READ indicates the number of input records read for each record 
type. 


@ PERCENT OF TOTAL indicates the number of records read for each type 
divided by the total number of records read. 


e AVG RECORD LENGTH, MIN RECORD LENGTH, and MAX RECORD 
LENGTH indicate, respectively, the average, minimum, and maximum lengths of 
the records read for each record type. ) 


e RECORDS WRITTEN indicates the number of output records written to the 
output data sets for each record type. 


e TOTAL indicates the total activity for each column. 


e NUMBER OF RECORDS IN ERROR indicates the number of spanned records 
(a record that is larger than the 4K SMF buffer size) that were found in error. 
This can occur when a physical I/O error occurs on a recording data set, while 
a record longer than 4K is being written. RMF record types 74, 76, and 79 or 
SMF record type 30 can be longer than 4K. 
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SUMMARY ACTIVITY REPORT 


START DATE-TIME 06/07/82 — 04:17:40 END DATE-TIME 06/07/85 — 23:29:02 


AVG. MIN. MAX. 
RECORD RECORDS PERCENT RECORD RECORD RECORD - RECORDS 
TYPE READ OF TOTAL LENGTH LENGTH LENGTH WRITTEN 
0 13 .01% 35.00 35 35 13 
2 0 1 
3 0 1 
4 25,399 12.90 % 265.93 183 935 25,399 
5 5,084 2.58 % 161.92 130 186 5,084 
6 11,526 5.86 % 90.80 88 94 11,526 
9 60 03 % 24.40 24 32 60 
10 368 -19 % 48.00 48 48 368 
11 331 17% 24.00 24 24 331 
19 2,483 1.26 % 68.00 68 68 2,483 
20 7,953 4.04 % 94.75 74 130 7,953 
21 3,115 1.58 % 48.00 48 48 3,115 
26 10,394 5.28 % 236.00 236 236 10,394 
31 23 01 % 58.00 58 58 23 
34 2,604 1.32 % 436.64 183 1,055 2,604 
35 2,602 1.32 % 130.00 130 130 2,602 
40 107,178 54.45 % 84.36 74 882 107,178 
43 17 01 % 32.00 32 32 17 
45 4 .00 % 28.00 28 28 4 
47 75 .04 % 04.53 52 90 75 
48 26 .01% 74.53 73 75 26 
70 360 18% 500.00 500 500 360 
71 359 18 % 344.00 344 344 359 
72 4,308 2.19 % 158.05 136 312 4,308 
73 360 18% 795.30 660 916 360 
74 1,083 55% 5,662.60 148 8,128 1,083 
75 2,513 1.28 % 160.00 160 160 2,513 
170 7,689 3.91% 95.00 95 95 7,689 
248 790 40 % 86.00 86 86 790 
249 108 .05 % 86.00 86 86 108 
TOTAL 196,825 100 % 159.00 24 8,128 196,827 
NUMBER OF RECORDS IN ERROR 0 


Figure 2-8, Summary Activity Report Example 
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Chapter 3: Defining The Use Of SMF 


An installation can define how it will use SMF through selecting SMF parameters. 
The parameters can be placed in a SYS] PARMLIB member SMFPRMxx, or the 
installation can use the IBM-supplied values in SMFPRMOO or the SMF defaults. 
You can specify SMFPRMxx parameters: 


Before the first IPL of a newly generated system by adding SMFPRMxx as 
a member of SYS1 .PARMLIB. 


At each initialization of SMF by entering the parameters at the console if 
PROMPT (LIST or ALL) is specified in the active SMF parmlib member. 


During execution of SMF by using the SET SMF operator command to specify 
a new SMFPRMxx member. 


During execution of SMF by using the SETSMF operator command to replace 
individual parameters in the SMFPRMxx member. 


SMFPRMxx Parameters 


The possible SMFPRMxx parameters are described in Figure 3-1. 


Note: If you specify the same keyword more than once, SMF uses the first valid 
specification read from the parmlib member, or the last one specified in an operator 
reply. 
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Meaning and Use Value Range Default Value 
ACTIVE a ACTIVE 


NOACTIVE 

Specifies a list of up to 36 VSAM data sets that are to be DSNAME (SYS1.MANX, 
used for SMF recording. Each data set must be named ee SYS1.MANY) 
SYS1.MANn, where n can be any alphameric character. 










Specifies whether or not SMF recording is to be active. 







DSNAME (data set) 
















The first data set specified is the primary SMF recording 
dataset. All other specified data sets are secondary data sets. 
















Specifies whether the system is to generate SMF data set N/A LISTDSN 
status messages to the operator at IPL or SET SMF time. 
The messages contain the following information for each 


data set used for recording: 


LISTDSN 
NOLISTDSN 







e dataset name 
@ data set status 
— active 
— alternate 
— dump required 
@ data set size (in number of 4096-byte blocks) 
@ percentage full 

































Specifies the system identifier to be used in all SMF records, | See SID (3081) 
where xxxx can be any four alphameric and/or special explanation 
characters. 


(xxxx) 


2IP aa [ser] 












The SID assigned is the 
four-digit processor 
mode! number taken 
from the PCCA control 
block, 









If you want to use one SMFPRMxx parmlib member for 
your entire installation, specify a SID parameter for each 
system and use the serial number subparameter on each 
SID parameter. SMF selects the SID with the serial 
number(s) that match the processor serial number(s) at IPL. 
The xxxx value associated with the serial number(s) will be 
the system identifier placed in each SMF record. 


For example, if SID(SYSA,006204) and 
SID(SYSB,006204,206204) are specified in the same 
parmlib member, and processor 006204 was |P Led as a 
uniprocessor, SID(SYSA,006204) applies. If the processor 
was IPLed as a multiprocessor, SID(S YSB,006204,206204) 
applies. 


























Notes: 

1. The SID parameter cannot be changed by a SET SMF or 
a SETSMF command. 

2. Note that it is possible for an installation to have more 
than one processor (such as a 3081 and a 3083) with 
the same serial number. In such cases, use a separate 
SMFPRMxx parmlib member for each processor. Other- 
wise, SMF will select the system identifier that contains 

the first occurrence of the matching serial number, re- 

gardless of the value specified for xxxx., 















REC (PERM) 









Specifies whether information for record type 17 (scratch 
data set status) is to be collected for temporary data sets. 
PERM specifies that record type 17 is to be written only 

for non-temporary data sets. 


ALL specifies that record type 17 is to be written for 
both temporary and non-temporary data sets. 






Figure 3-1. SMFPRMxx Parameters (Part 1 of 4) 
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J 





C 



























NOMAXDORM 


STATUS (hhmmss) 
NOSTATUS 


PROMPT (option) 
NOPROMPT 











MAXDORM (mmss) 


JWT (hhmm) 


SYS (options) 


Specifies the amount of real time that SMF allows data 
to remain in an SMF buffer before it is written to a 
recording data set, where mm is real time in minutes and 
ss is seconds. NOMAXDORM specifies that the data 
remains in the buffer until the buffer is full. 








0001-5959 MAXDORM (3000) 

30 minutes 
000001- STATUS (010000) 
240000 1 hour 


0001-2400 JWT (0010) 
10 minutes 
N/A 


PROMPT (ALL) 






Specifies the amount of real time between creations of 
record type 23 (SMF statistics) where hh is the hours, 
mm is the minutes, and ss is the seconds. 

















Specifies the maximum amount of time that a job is 
allowed to wait continuously, where hh is the amount of 
real time in hours and mm is in minutes. When the 
specified time limit has expired, the time limit exit, 
|EFUTL is entered (if active). 


Note: If TIME=1440 is coded on the JOB or EXEC JCL 
statement, IEFUTL is not invoked for that job. 








Specifies whether the selected SMF parameters are to be 
displayed on the system console at IPLtime. The 

operator can be prompted for a reason for the IPL or to 
modify the parmlib parameters. The options areas follows: 


e IPLR specifies that the Operator is to supply a reason 
for the IPL. 

e LIST specifies that the operator can modify the SMF 
parameters. 

e ALLspecifies that the operator is prompted for the 

IPL reason and can modify the SMF parameters. 















NOPROMPT specifies that the parameters are not listed 
and the operator is not prompted unless there is a syntax 
error in the parmlib member. 


NOPROMPT is the default if PROMPT is specified without 
an option. PROMPT(ALL) is the default if no keyword is 
specified. 























See each See each option 


option 


Specifies the global recording options for the entire system. 
The options include the records to be collected, the real 

time intervals between recording, and the valid SMF exits. 
If the same option is specified more than once, the first valid 
specification read from the parmlib or the last one specified 
in a operator reply, is used. The options are as follows: 









aa,bb 
( 4 aa,bb:zz ) 
aa,bb,... 


TYPE TYPE (0:255) 


NOTYPE 













TYPE specifies the record types to be collected by SMF, 
where aa, bb, and zz are the decimal notations for each 

record. A colon is used as a delimiter to indicate that all 
records from bb up to and including zz are to be recorded. 


Figure 3-1. SMFPRMxx Parameters (Part 2 of 4) 
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Meaning and Use Value Range Default Value ) 


SYS (options) NOTYPE specifies that all records except those specified 

(continued) are to be written by SMF, where aa, bb, and 2z are the 
decimal notations for each record. A colon is used asa 
delimiter to indicate that all records from bb up to and 
including zz are not recorded. 


NOINTERVAL 000001- NOINTERVAL 
INTERVAL (hhmmss) 240000 


NOINTERVAL specifies that no checkpoints are taken, 
NOINTERVAL is the default. 


INTERVAL specifies the amount of real time between each 
checkpoint, where hh is the hours, mm is the minutes, and 
ss is the seconds. At each checkpoint, a type 30 record if 

specified, is written. For TSO users, a type 32 record can 

also be written. 


The INTERVAL options allows the user to preserve 
accounting data for long-running jobs or TSO sessions. 
Because accounting data is recorded for each job or task 
each time the interval expires, the data is not completely 
lost in the event of a system failure. However, using the 
interval option causes some system Overhead. For this 
reason, caution should be used when specifying this value. 
Note that the INTERVAL value must be greater than the 
JWT value. If the interval is less than the SWT time, 

the IEFUTL exit is not taken. 


EXITS (exit name, exit name,...) See explanation 
NOEXITS 


EXITS specifies which SMF exits are to be invoked. A 

maximum of 15 exits are allowed; if an exit is not specified wi 
then it is not invoked. |f this system parameter is not 

specified, all SMF system exits are allowed. 


NOEXITS specifies that SMF exits are not invoked. 


NODETAIL 
DETAIL 


Specifies the level of data collection. When DETAIL is NODETAIL 
specified for TSO, type 32 records contain the total CPU 

time under TCBs and SRBs and the total number of 

TGETs, TPUTs, EXCPs, and transactions associated with 

the command. When DETAIL is specified for STC, type 

30 records (subtypes 4 and 5) contain all the EXCP sections 

for the step or job. 





Figure 3-1. SMFPRMxx Parameters (Part 3 of 4) 
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Meaning and Use Value Range Default Value 


SUBPARM (name 
(parameters)) 











































Specifies the information to be passed to a specific 
subsystem where: 










name specifies a One to four character 
subsystem name. The first character 
must be an alphabetic or national 
(F#, @, or $), and the remaining characters 
can be either alphameric or national. 
parameters specifies a 1 to 60 character information 
string to be passed to the subsystem 
specified in name. SMF does not check 
the validity of the information string. 
The inner set or parentheses marks the 
beginning and the end of the information 
string. 








SUBSYS (name,options) Specifies what data is to be collected and recorded for 
a specific subsystem, where name specifies a one to 
four character subsystem name. The first character must 
be alphabetic or national (# @, or $), and the remaining 
characters can be either alphameric Or national. Through 
this publication, the term subsystem means the one to 
four character name specified in the SUBSYS parameter 
in the SMFPRMxx parmlib member. The options are 

the same as the options that can be specified with the 

SYS keyword. If a subsystem option is not specified, 

the corresponding SYS option is used. The name is not 
validity checked. Data can be recorded for up to eight 
subsystems in any IPL, including both those specified 

at IPL and through subsequent SET commands. When 

the limit is reached, no additional subsystems can be 
added. The two SMF -defined subsystems are STC and 
TSO. Work started from the operator console is associated 
with the STC subsystems. Logged on TSO users are assigned 
to the TSO subsystem. Batch jobs are assigned to the job 
entry subsystem that presented the work to the system. 
The name of the job entry subsystem (for example, JES2 
or JES3) is specified in the SCHEDULR sysgen macro 
instruction. 


Figure 3-1. SMFPRMxx Parameters (Part 4 of 4) 
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SMF Functions ) 


The following section describes some of the functions that can be controlled by the 
SMFPRMxx parameters. 


Collecting SMF Statistics 
Type 23 records collect SMF statistics. Creation of the type 23 record allows the 


installation to track SMF recording activity. The type 23 record is written at the 
expiration of the interval specified in the STATUS parameter. 


The MAXDORM parameter allows the installation to minimize the amount of 
data lost because of system failure. By specifying MAXDORM, the installation 
specifies the period of real time that data is permitted to remain in the SMF buffer 
before it is written. 


Interval Accounting 


Record type 30 provides accounting information and consolidates data that is also 
found in record types 4, 5, 20, 34, 35, and 40. However, using the type 30 record 
simplifies accounting by means of installation-written post processing routines. 
Record type 30 is written when: 


e A TSO session, started task, or batch job starts 
e A TSO session, batch step, or batch job ends ) 


e The recording interval expires 


A recording interval is specified through the INTERVAL option of the SYS or 
SUBSYS keywords. A recording interval makes it possible to checkpoint 
accounting data so that if a system failure occurs, not all of the accounting data is 
lost. When the recording interval expires, a type 30 record is written that contains 
the accounting information for the job. At the end of a step, a final interval record 
includes the accounting information for the time between the last interval record 
and the end of the step. In addition, SMF produces a type 30 record that contains 
the accounting data for the entire step regardless of the number of intervals that 
have expired. 


If the internal value is changed through the SET SMF or SETSMF command, the 
new interval does not take effect until the current interval expires. If interval 
recording is not active when a job is started, there is no interval recording for that 
job. If interval recording is turned off and then back on by means of a SET 
command, interval recording starts at the new rate, at the beginning of the next 
step. 
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In the following example, the installation decided to take a checkpoint of 
accounting data for started tasks (such as VTAM) at a one-hour interval. The 
SMFPRMxx options specified: 


SUBSYS(STC, INTERVAL(010000)) 


The values specified cause a type 30 record to be produced each hour after the 
start of each started task step. The record contains the accounting data for the 
resources used during the previous hour. 


TSO Command Accounting 


Record type 32 contains the number of TSO commands issued by a TSO user. The 
record is written when a TSO user logs off or when an SMF recording interval 
expires. 


Type 32 records allow the installation to keep track of individual TSO 
commands entered during a TSO session, during recording interval, or in a CLIST. 
If no commands are entered during a reporting interval, no record is created. 


The installation can specify, through the DETAIL parameter in SMFPRMxx, 
that the record is also to include the total CPU time under TCBs and SRBs and the 
total number of TPUTs, EXCPs, transactions, and TGETs associated with the 
command. 


To use the type 32 record and TSO command accounting, you must have installed 
TSO Extensions for MVS/XA. 


Many TSO commands, such as EDIT, have subcommands. These subcommands 
are also counted in the type 32 record. However, these subcommands are not re- 
corded as entered at the terminal; they are recorded with a prefix that associates 
the subcommand with a command. For example, under EDIT, the INPUT sub- 
command is recorded as EDINPUT. The prefixes are described later in this section. 


All TSO commands attached directly by the terminal monitor program (TMP) 
are counted. However, some TSO products or, possibly, user applications currently 
do not count TSO commands and thus do not support the type 32 record. For 
example, the Interactive Problem Control System (IPCS) does not count TSO 
commands. However, TSO subcommands are counted. 
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The TSO command interface enables a user application to avoid this problem. ) 
The interface requires the user application to take the following steps both before = 
each TSO command (or subcommand) to be counted begins and after the command 

completes: 


e Load register 1 with the address of a parameter list containing a four-byte flag 
word. The parameter list must start on a word boundary. The high-order bit 
of this word is set as follows: 

— |] indicates the start of a command 
— Qindicate that the command has completed. 


Following the four-byte flag word is an eight-byte command (or prefixed-sub- 
command) name field. The command must be left-justified and padded with 
blanks. 


e Load register 15 with X‘19’. 
e Issue SVC 109. 


The user of this interface must include the name of the command or prefixed- 
subcommand in module IEEMB846 before invoking the interface. 


The IBM-supplied module IEEMB846, contains a partial list of the TSO com- 
mands, prefixed subcommands, and aliases that are counted in the type 32 record. 
All other commands are counted in the ‘****OTHER’ field. 


An installation can use the IBM-supplied IEEMB846 or create its own module 
in SYS1.LINKLIB. The SMFTSOCM member of SYS1.SAMPLIB is provided so 
that the user can add or delete commands for the installation. The SMFTSOCM 
member contains the source code for the IBM-supplied IEEMB846. The format of 





IEEMB846 is: 
Offser Length Content 
0 4 Number of commands in the module 
4 4 Reserved 
8 8 Command name field 
16 8 Command name field 


Each command name field is 8 characters long. Therefore, each name must be 
left-justified and padded with blanks. The commands can appear in any order. 
However, by placing the most frequently used commands near the beginning of the 
module and deleting the commands that are not used, an installation can reduce the 
average time SMF needs to find the command. For example, after the following 
CSECT is link-edited into SYS1.LINKLIB, the ALLOCATE, ALLOC, SEND and 
GETINPUT commands are recorded in record type 32. (The GETINPUT command 
is a locally-defined command). 
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IEEMB846  CSECT 
DOF 
Dc FO’ 
DC _ CL8‘ALLOCATE” 
DC —- CL8‘ALLOC##B’ 
DC — CL8‘SEND} BBB” 
DC —- CL8‘GETINPUT’ 
END 


Note: Both ALLOCATE and ALLOC, its alias, are specified. If ALLOC, or any 
other alias, is not explicitly specified in IEEMB846, each use of the alias is counted 


under “***OTHER’ and not under the corresponding command. 


When adding subcommand names to IEEMB846, use the following prefixes: 


Command Subcommand Prefix 
ACCOUNT AC 

EDIT ED 

OUTPUT O 

OPERATOR OP 

TEST T 

User-defined U 


If the length of the prefix plus the subcommand name exceeds eight characters, the 
subcommand name is truncated on the right. For example, the CONTINUE sub- 
command of OUTPUT appears in IEEMB846 as OCONTINU. 


The subcommand prefix “‘U” allows an installation to collect data on user-defined 
subcommands as long as they use the TSO Command interface. An installation that 
has more than one user-defined command processor can add a one-digit qualifier 
(0-9, A-Z) to the prefix to differentiate between user commands. 
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Recording Status Changes 2 


Record type 90 describes changes in SMF and system status. The type 90 record 
allows the installation to track operator changes (such as the use of the SET or 
SETSMF command), and with the PROMPT option, to establish availability and 
reliability statistics for the processor. 


If PROMPT (IPLR or ALL) is specified, the system issues message IEE9S6A 
when an IPL occurs. This message prompts the operator to reply with the time 
when the failure occurred, the name of the operator, and the reason for the IPL. 
This information is recorded in a type 90 record. For more information on message 
IEE956A, see System Messages. 


The installation can set up standard operator replies to the prompt message and 
then use a post processing program to summarize the reliability data contained in 
the type 90 record. For example, an operator reply of FTIME=00.00.00 might 
indicate a scheduled IPL while any other reply indicates a system failure. Also,a 
standard set of IPL reasons might be provided to the operator, such as scheduled 
production, processor failure, channel failure, JES failure code xxxx, or scheduled 
test. 


Started Task Accounting 


For accounting purposes, the system sees the master address space, system address 

spaces, mounts, job entry subsystems, and tasks initiated with a START command 2 
at the operator console as started tasks. The system does accounting for started 

tasks much as it does for batch jobs and TSO work. Started task accounting in- 

cludes: 


e Accumulating CPU time under started task TCBs and SRBs 
e Counting started task 1/O operations 

e Invoking SMF exits on behalf of started tasks 

e Creating SMF records for started task activity 


The SYS default in SMFPRMxx requests that SMF write all possible records for 
what the system sees as started tasks. For started task accounting, SMF writes 
record types 4, 5, 6, 14, 15, 17, 18, 19, 20, 23, 25, 26, 30, 40, 57, 62, 63, 64, 67, and 
68. 


You can suppress started task accounting records by suppressing the accounting 
record types through the SUBSYS option in SMFPRMxx (STC parameter). To sup- 
press all SMF records for started task accounting in a JES2 system, specify: 


SUBSYS(STC,NOT YPE(4,5,14,15,17,18,19,20,23,30,40,62,63 ,67,68)) 
To suppress all SMF records for started task accounting in a JES3 system, specify: 
SUBSYS(STC,NOTYPE(4,5 ,6,14,15,17,18,19,20,23,25 ,26,30,40,57,62,63,67,68)) 
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In either case, specifying any other record types might cause loss of data other 
than accounting data for started tasks. For example, a JES2 installation might run 
the Resource Measurement Facility, which the system sees as a started task, to 
monitor system activity. To suppress started task accounting records for the 
Resource Measurement Facility, the installation might inadvertently specify: 


SUBSYS(STC,NOT YPE(4,5 ,14,15,17,18,19,20,30,40,62,63,67,68,70)) 


Because this specification includes record type 70, the installation is suppressing, 
in addition to started task accounting data on the Resource Measurement Facility, im- 
portant data collected by the Resource Measurement Facility itself on CPU activity. 


For an initiator, the only data that is meaningful in a type 4, 5, or 30 record 
is job or session name, program name, step name, and reader start time and date. 
IEFIIC in the program name field identifies an initiator record. 


Because CPU time is accumulated for started tasks, wait time limits and job step 
time limit abends can occur. To avoid these abends, you can code TIME=1440 
on the EXEC statement in the cataloged procedure or set on the system task bit 
in the program properties table (PPT). (For more information on the program 
properties table, see System Modifications). 


Notes: 


1, MSTRJCL has been modified to include TIME=1440, 
2. Many IBM-supplied entries in the PPT have the system task bit set on. 


Passing Data To a Subsystem 


SMF allows an installation to pass up to 60 characters of information (such as 
accounting information) to a user-defined subsystem; a user-defined subsystem is 
any subsystem other than TSO, STC, JES2, or JES3. You specify the information 
to be passed in the SUBPARM parameter of the SMFPRMxx parmlib member, and 
it can be changed by an IPL or by the SET or SETSMF operator command. 


To use the information, the subsystem issues the SMFSUBP macro during its 
initialization to determine if any SUBPARM information is present or if the values 
have been changed by a subsequent IPL. (See “Using the SMFSUBP Macro to 
Determine Subsystem Parameters” later in this book.) 


In response to a SET command, SMF issues a subsystem interface (SSJ) call 
to all user-defined subsystems that have a SUBPARM option specified. (For 
more information on the subsystem interface, see Diagnostic Techniques.) In 
response to a SETSMF command, SMF issues a SSI call only to the subsystem 
specified in the SETSMF command. 


To determine if any values that affect its operation have been changed, each 
subsystem, upon receiving the SSI call, must issue the SMFSUBP macro instruc- 
tion. If the subsystem determines that the information string passed to it is incor- 
rect, it uses the SMFCHSUB macro instruction to change the information. (See 
“Using the SMFCHSUB Macro to Change Subsystem Parameters”.) 
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Selecting SMF Records Using SMFPRMxx Parameters 2 


SMF records are selected by specifying either the type desired or the types not 
desired with the TYPE or NOTYPE option of the SYS or SUBSYS parmlib 
parameter, 


If any one of record types 14, 15, 17, 18, 62, 63, 64, 67, or 68 is specified 
with theTYPE option, data is collected for all records. Likewise, if either record 
type 19 or 69 is specified with the TYPE option, data is collected for both records. 
However, only those records that are selected as a result of TYPE or NOTYPE 
request are wnitten to the SMF data set. 


User-written exit routines [IEFU83 and IEFU84 (SMF writer) and IEFACTRT 
(termination) can also control which records are to be written to the SMF data set. 
After inspecting an SMF record, these routines return a code to the system in- 
dicating whether the record is to be written to the SMF data set. 


Entering SMFPRMxx in SYS1.PARMLIB 


When you have determined which SMF parameters to use, place them in an 
SMFPRMxx member of SYS] .PARMLIB. The two alphameric characters, 
represented by xx, are appended to SMFPRM to identify your SMFPRMxx member. 
If you do not specify an SMFPRMxx member (with system parameters, such as 
SMF=01 for member SMFPRMOl1, or with an alternate member, such as 


IEASYSxx), the default member SMFPRMOO is used. The parameters in 
SMFPRMOO0 are: > 
ACTIVE /* ACTIVE SMF RECORDING®/ 
DSNAME(SYS1.MANX,SYS1.MANY) /*TWO DATA SETS MANX AND MANY ®*/ 
PROMPT(ALL) /*PROMPT THE OPERATOR FOR OPTIONS ®/ 
REC(PERM) /* TYPE 17 PERM RECORDS ONLY*/ 
MAXDORM(3000) /*WRITE AN IDLE BUFFER AFTER 30 MIN*/ 
STATUS(010000) /*WRITE SMF STATS AFTER 1 HOUR*/ 
JWT(0010) /*522 AFTER 10 MINUTES */ 

$1D(3081) /*SYSTEM ID |S 3081*/ 

LISTOSN /*LIST DATA SET STATUS AT IPL*/ 


SYS(TYPE(0:255) EXITS(IEFU83,|EFU84,IEFACTRT,IEFUJV,IEFUS],IEFUJP, 
IEFUSO,IEFUJIIEFUTL,IEFU29), NOINTERVAL,NODETAIL) 


/* WRITE ALL RECORDS AS THE SYSTEM DEFAULT, TAKE ALL KNOWN EXITS. 
THERE ARE NO DEFAULT INTERVAL RECORDS WRITTEN. ONLY SUMMARY 
TYPE 32 RECORDS ARE WRITTEN FOR TSO. */ 


SUBSYS(STC,EXITS(IEFU29 ,IEFU83, IEFU84,IEFUJP,IEFUSO)) 


/* WRITE ALL RECORDS AS BY SYSTEM DEFAULT, TAKE ONLY FIVE EXITS, NOTE: 
IEFU29 EXECUTES IN THE MASTER ASID WHICH IS A STC ADDRESS SPACE SO 
[EFU29 MUST BE ON FOR STC. USE ALL OTHER SYS PARAMETERS AS A DEFAULT ®/ 
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The SMFPRMxx parameters can be entered in any order; however, note the 
following coding restrictions: 


e Code each series of parameters in logical records no more than 80 bytes long. 
e Use columns 1-71; columns 72-80 are ignored. 

e Enter each parameter in the format: keyword(value). 

e Avoid embedded blanks. 


Indicate continuation by placing a comma after the last entry on a record, 
followed by a blank before column 72. 


e Comments must be bracket by /* and */. 


To add the SMFPRMxx parameters as a member of SYS1.PARMLIB, use the 
IEBUPDTE utility program. Figure 3-2 illustrates sample JCL for using IEBUPDTE 
to enter SMFPRMO1 into SYS1.PARMLIB. To change the default member, 
SMFPRMOO, or the installation-defined SMFPRMxx member, replace them with a 
new version by again executing IEBUPDTE. For information on the IEBUPDTE 


program, see Utilities. 


/IENTER JOB MSGLEVEL=1 

I EXEC PGM=IEBUPDTE,PARM=NEW 

/ISYSPRINT DD SYSOUT2A 

IISYSUT2 DD DSNAME=SYS1.PARMLIB,DISP=(OLD,KEEP)+ 
IISYSIN DD DATA 


/ ADD LIST=ALL,NAME=SMFPRMO01,LEVEL=01,SOURCE=0 
(SMFPRMO1 member) 

y | ENDUP 

/* 


179 access SMFPRMOO0 on the distribution package before SYSGEN, use the 
SYS1.APARMLIB data set. 


Figure 3-2. Sample JCL for Entering SMFPRMO1 into SYS1.PARMLIB Using IEBUPDTE 


If PROMPT(LIST or ALL) was specified, the operator can modify the values in 
SMFPRMxx parameter from the console during system initialization or SET SMF 
processing. If parameter errors occur, the operator will be prompted for correct 
parameters regardless of the value specified for PROMPT. 


Using the SET Command 


The SET operator command can be used to restart SMF or modify the SMF recording 
options dynamically by specifying which SMFPRMxx parmlib member is to be used. 
The format of the command is: 


SET _ 
T SMF=xx 


where xx is the two-character identifier of the member of SYS1 PARMLIB that 
contains the SMF options. 


If SMF terminates, you may use the SET command to restart SMF; it is not 
necessary to IPL again. For more information on using the SET command to restart 
SMF, see System Commands, 
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The SET command also allows the installation to replace the existing SMF options. J 
For example, an installation can activate SMF recording after an IPL in which 

NOACTIVE is specified by using the SET command and choosing the parmlib member 

that contains the ACTIVE option. In addition, the installation can use the SET 

command to reactivate SMF recording after an I/O error has terminated recording; 

however, the installation should define a new data set or correct the cause of the 

I/O error before reactivating SMF recording. 


Notes: 


1. To avoid installation exit communication problems, the installation should 
terminate all address spaces except the master scheduler address space, the system 
address spaces (such as PCAUTH, ALLOCAS, and GRS) and the job entry 
subsystem before issuing a SET command that changes the EXIT keyword. 


2. The SET command cannot be used to change the SID parameter; if a value is 
specified, it is ignored. 

3. The new values for STATUS or MAXDORM do not take effect until the old 
ones, if any, expire. 

4. SET SMF, SETSMF, and DISPLAY SMF commands cannot run simultaneously. 
One waits for the other to complete before starting. 


5. A maximum of eight subsystems are allowed for each IPL. This is a combined 
total of those specified at IPL and subsequent SET commands. If the maximum 
is reached, no new subsystems may be added. Those subsystems previously 
specified can be given different options. 


6. Recording data set switching does not take place at SET time unless it is neces- 
' sary. For example, if the current active data set is not included in the new » 
options, the first empty-data set in the new data set list becomes the active 
recording data set. 


7. If recording is not active at SET SMF time, the first non-full data set is used 
as the recording data set. 


Using the SETSMF Command 


In contrast to the SET operator command with the SMF option, which allows 
an installation to specify a different SMFPRMxx parmlib member, the SETSMF 
operator command allows an installation to add a SUBPARM parameter or to 
replace any previously-specified parameter in the active SMF parmlib member 
except the ACTIVE, PROMPT, SID, or EXITS parameters. The SETSMF com- 
mand cannot be used with a parmlib member that specified NOPROMPT. The 
format is: 


— 
Ss 


The parameters are: 


\ parameter (value),... 


parameter 
specifies any SMF parmlib parameter except ACTIVE, PROMPT, SID, or EXITS. 


value 
specifies the new value for the specified parameter. 
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Notes: 

1. More than one parameter can be changed as long as the length of the command 
does not exceed 124 characters. 

2. Both the SUBSYS and SUBPARM specifications can be changed on the same 
SETSMF command as long as the subsystem name is the same. 

3. SET SMF, SETSMF, and DISPLAY SMF commands cannot run simultaneously. 
One waits for the other to complete before starting. 


4. The new values for STATUS or MAXDORM do not take effect until the old 
ones, if any, expire. 


Using the DISPLAY Command 


The DISPLAY (D) operator command can be used to display the status of the 
SMF data sets or the current SMFPRMxx options, to the operator console. The 
format is: 


(De *Y pour 8} | bossa 


The parameters are explained below: 
SS 
specifies that the status of the SMF data sets is to be displayed. 


O 
specifies that the current SMFPRMxx options are to be displayed. 


3 


,L=cca 
specifies the console(cc) and the display area(a) where the action specified 
by S or O is to take place. 


Note: SET SMF, SETSMF, and DISPLAY SMF commands cannot run simul- 
taneously. One waits for the other to complete before starting. 
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Chapter 4: User-Written Exit Routines and Facilities 


SMF has exits in the control program that can link to user-written routines for 
monitoring jobs or job steps at various points in their processing cycles. These exits 
can execute in either 24-bit addressing mode or 31-bit addressing mode. For more 
information on 31-bit addressing, see SPL: 31-Bit Addressing. An installation can 
use any or all of the SMF exits by including user-written exit routines in the 
appropriate distribution libraries before SYSGEN or in SYS1.LPALIB after SYSGEN. 
SMF automatically provides dummy routines for all unused exits. (For detailed 
information on adding user-written exit routines, see “Including Exit Routines in the 
Operating System”’ in the chapter “System Requirements and Considerations’’.) 


Chapter 4 is divided into three parts: 
@ Part [ describes user-written exit routines. 
e Part II describes testing exit routines. 


| e Part III describes exit routine facilities. 


Part I — User-Written Exit Routines 


Part I introduces the SMF exits. It briefly describes when each exit is called, the 
parameters passed to it, and the return codes required from it. 


Exit Routines and Their Characteristics 


SMF supplies exits, which can link to user-written exit routines, as follows: 


@ The job validation exit TEFUJV) receives control from the converter before 
each job control statement (or cataloged procedure) in the input stream is 
interpreted. This exit also receives contro] after all the JCL is converted and 
again after all the JCLis interpreted. It is not taken for JCL comment state- 
ments. A return code from this exit indicates whether processing of the job 
is to be continued. 


@ The job initiation exit TEFUJI) receives contro! from the initiator before a job 
on the input queue is selected for initiation. A return code from this exit 
indicates whether the job is to be started or canceled. 


@ The step initiation exit (IEFUSI) receives control from the initiator before each 
job step is started (prior to allocation). A return code from this exit indicates 
whether the job step is to be started or the job is to be canceled. 
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e The time limit exit (IEFUTL) receives control from the timer interruption 
handler when one of the following time limits expires: the job CPU time limit 
(from the JOB statement); the step CPU time limit (from the EXEC statement 
or the default from the job entry subsystem): or the continuous wait time limit for 
the job (from the SMFPRMxx JWT parameter). A return code from this exit 
indicates whether the job step is to be terminated or processing is to be 
continued with a new time limit. 


e The SYSOUT limit exit (IEFUSO) receives control from the job entry subsystem 
when the number of records written to an output data set exceeds the output limit 
for that data set. A return code from this exit indicates whether the job is to be 
terminated or processing is to be continued using a new limit. 


@ The SMF record exit (IEFU83) receives control from the SVC 83 routine before 
each record is written to the SMF data set. A return code from this exit indicates 
whether the current SMF record is to be suppressed. 


e The termination exit (IEFACTRT) receives control from the terminator on the 
normal or abnormal termination of each job step and job. A return code from 
this exit indicates whether the job is to be continued (for job steps only) or 
terminated, and whether the SMF fermination records are to be written to the 
SMF data set. 


@ The job purge exit (IEFUJP) receives control from the job entry subsystem when 
a job is ready to be purged from the system (that is, after the job has terminated 
and al] SYSOUT output that pertains to the job has been written). A return code 
from this exit indicates whether the SMF job purge record is to be written to the 
SMF data set. 


e The SMF dump exit (IEFU29) receives control from the SMF writer when an 
SMF data set becomes full. A return code from this exit indicates whether or 
not the dump message (IEE3621) is to be issued. 


@ The SMF record exit (IEFU84) receives control when the SMF writer SVC is 
branch entered. A return code from this exit indicates whether the current 
SMF record is to be suppressed. 


Figure 4-] summarizes when each SMF exit is called, the modules that call each 
user-written exit routine, the information passed to each exit (in addition to the 
common exit parameters, described in Figure 16), and the return from each exit to 
the control program. 
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J 












IEFVHEB | Prescan in SMFEXIT | 1EFUJV (entry JCL statement image, type Continue or cancal. 
Converter codes 0-8) of JCL statement, 

IEFVHE Converter SMFEXIT | IEFUJV (entry converterm parameter 
Termination code 16) 

IEFVHH Interpreter SMFEXIT | IEFUJV (entry 
Termination code 32) 


IEFSMFIE | Job Initiation | SMFEXIT | IEFUJI Programmer name, job Continue or cancel. 
priority, job accounting 
fiekds. 


IEFSMFIE | Step Initiation | SMFEX!T Job step name, program Continue or cancel. 
name, step accounting 
fields. 
IEATLEXT | Timer SMFEXIT | IEFUTL Continue with new time limit or 
Expiration cancel. 


HASPAM!_ | Output Limit errenr fier Continue with new limit or cancel. 
|ATDMEB~ Expiration 
IGCOOO0BC | SVC Call to SMFEXIT | 1EFU83 SMF record to be written. Write or do not write record to 
SMF Writer SMF data set. 
SMF Buffer 
Time 


IEEMB830 |Branch entry SMFEXIT IEFU84 SMF record to be written. Write or do not write record to 
call to SMF SMF data set. 


IEFTB?721 = |Job SMFEXIT IEFACTRAT Job step name, programmer | Continue or cancel; write or do 
Termination name, job CPU time, job not write record to SMF data set. 
accounting fields, step CPU 
IEFTB721 |Step SMF EXIT IEFACTRAT time, step accounting fields, 
Termination completion code, SMF 
termination record. 
















HASPMISC!| Job Purge SMFEXIT iIEFUJP SMF job purge record, Write or do not write record to 





IATOSDR2 subsystem ID. SMF data set. 
TEEMB829 |SMF Dump SMFEXIT IEFU29 SMF data set name. Tell operator to clear or 
Time not to clear SMF data set. 
| JES2 only 
2 JES3 only 


Figure 4-1. Exit Routine Charactenistics 
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Sample Exit Routines in SYS1.ASAMPLIB 





Sample assembler language exit routines for some SMF exits are provided in the 
member SMFEXITS of SYS1.ASAMPLIB. Figure 4-2 shows sample JCL for 
obtaining a listing of these sample routines. 





//PRINT JOB MSGLEVEL=1 

iT} EXEC PGM=IEBPTPCH 

//SYSPRINT DOD SYSOUT=A 

HISYSUT1 DD DSNAME=SYS1.ASAMPLIB,DISP=(OLD,KEEP), 
M/ UNIT=xxxx,VOLUME=SER=xxxxxx2 

IISYSUT2 DD SYSOUT=A 

/ISYSIN DD . 


PRINT TYPORG=PO MAXNAME=#1,MAXFLDS=1 
MEMBER NAME=SMFEXITS 
RECORD FIELD=(80) 

/* 


1The volume and unit parameters depend upon your instailation’s request. 





Figure 4-2. Sample JCL For Obtaining a Listing of Sample Exit Routines 


A summary of the sample exit routines in SYS1.ASAMPLIB follows: 


e IEFUJV -— Sample routine checks the validity of a continued JOB statement 
and of values supplied for REGION, PRTY, TIME, and accounting 
parameters in the JOB statement. The routine uses characters 
from the account number to index a table that contains allowable 
values for these parameters. If any value is invalid, the sample > 
IEFUJV routine terminates the job. 


e [EFUJI — Sample routine determines how long a job has been on the input 
job queue before it is initiated. It then writes this value and the 
job priority to the SMF data set as a user record. 


e IEFUSI — No sample provided. 


e [EFUTL -— Sample routine terminates a job if either the job CPU time limit or 
the job step CPU time limit has been exceeded. If the continuous 
wait time limit for the job has been exceeded, the routine extends 
the limit twice; on the third entry for exceeding the continuous 
wait time limit, it cancels the job. The continuous wait time limit 
is not an accumulation of all the time the task spends waiting but 
rather a single continuous wait penod that exceeds the specified 
limit. Each time the routine is entered for exceeding the continuous 
wait time limit, it writes a record describing the action taken to 
the SMF data set. 


e IEFUSO - — No sample provided. 
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e IEFU83 -— Sample routine determines whether the record to be written is an 
IPL record. If it is, the routine writes to the operator with a reply 
request for the record types to be written. If the record is not an 
IPL record, the return code depends upon the records currently 
requested. 


The sample [IEFU83 routine has.a special macro definition for 
“write to operator with reply” so that output normally directed to 
the operator is suppressed and a standard reply is assumed for 
testing with the TESTEXIT procedure. Remove this macro 
definition if you want the message printed at the console. The 
sample routine also has special macro definitions for “‘write to 
operator” and “wait”, which generate no-op instructions. 


e JEFU84 -— No sample provided. 


e IEFACTRT— Sample routine changes the SMF job termination (types 5 and 35) 
and job step termination (types 4 and 34) records (unless the job 
step is flushed) to user records, and attempts to write them to the 
SMF data set. If the data set is full, the routine writes a message 
to the console indicating that SMF records are being lost. At job 
termination, the routine writes a record containing the job name, 
programmer’s name, and account number to the SYSOUT data set. 


e IEFUJP -— No sample provided. 


e JEFU29 — No sample provided. 


Writing Exit Routines 


This section describes: 


e Exit routine restrictions and facilities, including information on communication 
among user-written exit routines; the common parameters passed to all routines; 
the SMF macro instructions, which are used to write records to the SMF data 
set; and the IFASMFR macro instruction, which is used to symbolically address 
fields in the SMF records. 


e Exit routines, including a full description of the parameters passed to each 
routine-and the required return codes. 


Exit Routine Restrictions 


This section describes only the restrictions and conditions common to most user- 
written exit routines. For those restrictions and conditions that involve only one 
or two exit routines, see the specific routine(s) later in this chapter. 


Before writing an exit routine, note the following user-written exit routine 
restrictions and conditions: 


e All user-written exit routines must be reenterable and refreshable 


because PLPA pages are stolen and can be paged-in but not paged-out. 
Any code changes would be overlaid by subsequent page-in. 
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e All user-written exit routines receive control via a BALR instruction. The ~ 
routines must save registers when they receive control and restore registers 
when they return control to the control program. Register 13 contains the 
address of the register save area; register 14 contains the return address; and 
register 15 contains the entry point address. 


e SMF exit routines can execute unchanged in MVS/XA. If the exit routines 
are rewritten to either address data above the 16-megabyte line or to reside 
above the 16-megabyte line, and are link edited again, SMF passes control to 
the exit routines in the proper addressing and residency mode. You 
establish addressing and residency modes at system initialization or 
through EXIT parameters on the SETSMF command. Exits that run in 
31-bit addressing mode must return control to SMF via a BSM instruction. 


e Figure 4-3 shows the storage proctection key in which each user-written exit 
routine receives control. 


IEFUJV (with entry code 32) 
IEFUJI 

IEFUSI 

IEFUTL 

IEFU83 


IEFU84 


IEFACTRT 


IEFU29 J 


IEFUJV (with entry codes 0-16) 
IEFUSO 
IEFUJP 





Figure 4-3. Storage Protection Keys 


e All user-written exit routines receive control with the system enabled for 
interrupts. 


e No user-written exit routines except IEFACTRT can write to the system output 
message data set. 


e Do not allocate installation-defined data sets to SYSOUT. 


e User exits must use standard linkage conventions. 
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Common 


e User-written exit routines entered for foreground jobs cannot access instal- 


lation-defined data sets. Routines entered for background jobs must write 
to installation data sets defined as follows: 


— A data set used by the exit routines IEFUJI, IEFUSI, IEFUTL and 

IEF ACTRT requires a DD statement in the initiator cataloged procedure. 
— A data set used by the IEFUJV and IEFUJP exit routines requires a DD 
statement in the job entry subsystem cataloged procedure. 
User-written exit routines IEFUSO, IEFU29, IEFU83, and IEFU84 cannot 
write to installation-defined data sets. 
— IEFUJV, IEFUJI, IEFACTRT, and IEFUSI cannot access ISAM data sets. 


e All user-written exit routines that issue a WIOR macro instruction should 
also specify the LONG=YES parameter in the WAIT macro instruction. 


e If you plan to use the TESTEXIT procedure for testing user-written exit 
routines, see ““TESTEXIT Exit Routine Requirements” in Part II “Testing Exit 
Routines”’ of this chapter. 


e Ifyou plan to use the IBM OS/VS Sort /Merge Program Product, do not 
create any records smaller than the minimum length required by the 
program. (When using tape work devices, the minimum length this program 
can sort is 18 bytes. Otherwise, the minimum is one byte.) 


e IEFUS84 cannot issue any SVCs. 


Exit Parameter Area 


When a user-written exit routine receives control, register 1 points to a list of four- 
byte addresses. The first entry in this list is common to all exit routines except 
IEFU83, IEFU84, and IEFU29. The first entry points to a parameter area that 

is 36 bytes long. 


Figure 4-4 describes the format of the common exit parameter area. Each job has 
its own common exit parameter area. Note that the fields in this parameter area are 
filled chronologically; therefore, not all fields are meaningful for all user-written exit 
routines. 
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Displacement F ield D ata S) 


from Pointer Size Format Description 
0 8 EBCDIC Job name 
8 4 binary Time, in hundredths of a second, reader recognized the JOB card for this job 
12 4 packed Date reader recognized the JOB card for the job, in the form OOY YDDDF 
where F is the sign 
16 4 EBCDIC System identification (taken from SID parameter?) 
20 8 EBCDIC User identification. SMF places this data in all subsequent records for this job. 
This field is initialized to EBCDIC blanks when each job is read@ 
28 1 binary Number of the step being processed 
29 1 binary Indicator of the SMF options selected by the user 
Bit Meaning When Set 
0 Reserved 
1 Reserved 
2 Reserved 
3 Data set accounting. Record types (see note 3) selected 
4 Volume accounting. Record types 19 or 69 selected 
5 Reserved 
6 Type 17 records will be written for temporary data set (REC(ALL)) 
7 lf O, background job. If 1, foreground job 


30 1 binary Restart indicator 
Bit Meaning When Set 


0 Automatic restart 
1 Automatic checkpoint/restart 
2 Step continue 
3 Reserved 
4 System restart ) 
5-7 Reserved 
31 1 EBCDIC Job class 
32 4 binary User-communication field. This field is intended for communication among user- 


written exit routines within a unique job. The field is initialized to zeros by 
the job entry subsystem when the contro! block is first passed to the converter. 





1 Modifications for the S|ID parameter are ignored during a system restart IPL for SMF record types 4, 5, 34 and 35. 
2 These fields are provided for user modification. 


31 one of record types 14, 15, 17, 18, 62, 63, 64, 67, or 68 is selected, this bit is set on. 


Figure 4-4. Common Exit Parameter Area 
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Exit Routines 


IEFUJV — Job Validation Exit 


IEFUJV receives control before the system converts each job control statement (or 
cataloged procedure) in the input stream and again after it converts all JCL. This 
exit routine also receives control after the system interprets all JCL. The procedure 
does not receive control for comment statements for console-started tasks. A user- 
written IEFUJV exit routine could do any or all of the following: 


Validate any account fields included in the JOB and EXEC statements (except 
symbolic parameters) by comparing them to a standard list. 


Validate or assign the REGION request. 

Validate or assign job TIME and job step TIME parameters. 

Control output stream data by using the OUTLIM or SPACE parameters. 
Check for authorization to use restricted data sets. 

Create user-written records. 


Assign the user identification to be included in both the SMF job/step 
termination record and the SMF job purge record. 


e Limit the size of temporary data sets handled by VIO. 


e@ Require checkpoint/restart for jobs requesting a large amount of CPU time. 


Enforce installation standards on usage of the ADDRSPC=REAL parameter. 


Notes: 


1. 


If a cataloged procedure is used, it is expanded before the IEFUJV exit routine 
receives control; the sequence of statements is JOB, EXEC PROC=..., 

EXEC PGM=... , followed by the other statements of the procedure. Override 
statements immediately precede the statements being overriden. Note, however, 
that the resolved values for symbolic parameters are not passed to the IEFUJV 
exit routine. 


. When modifying a JCL statement, do not include additional JCL statements or 


continuation cards. Also, when adding or modifying operand fields, begin the 
first operand field in the same place that it was before any additions or 
modifications were made. 


. Depending upon the processing to be performed, it may be more efficient to 


check JOB and EXEC statement accounting fields in the IEFUJI exit routine and 
the first IEFUSI exit routine, respectively. The accounting fields are passed as 
parameters to IEFUJI and IEFUSI, making a statement scan routine unnecessary. 
Either of these exit routines can assign user identification, and the IEFACTRT 
exit routine can write messages to the system output message data set. 


. To use installation-defined data sets with this exit routine, you must define them 


with a DD statement in the job entry subsystem cataloged procedure. When 
running JES2, you must also define the data sets with a DD statement in the 
initiator cataloged procedure. 
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5. When running JES2, you can use the job statement accounting field scan exit 
(Exit 3), as well as the IEFUJV exit. Exit 3 interprets any variables in the JOB 
card accounting field, and sets the appropriate fields in JES2 control blocks 
representing these variables. Because the exit receives control before the IEFUJV 
exit, do not use the JEFUJV exit to change the following fields of the JOB card: 
CLASS, MSGCLASS, NOTIFY, PRTY, PASSWORD and TYPRUN. For more 
information about Exit 3, see System Programming Library: JES2 Initialization 
and Tuning. 

When running JES3, a JES3 user can use JES3 user exits, in addition to the 
JEFUJV exit, to write programs to examine and change the results of interpreter 
processing and allow the job to proceed or to flush the job from the system. For 
more information about the JES3 user exits, see System Programming Library: 
JES3 User Modifications and Macros. 

6. For jobs canceled by IEFUJV from the converter, only SMF record types 6 and 
26 are generated. 

7. Conversion might take place on one CPU and interpretation of the same job on 
another. Therefore, the LEFUJV exits could receive control on different CPUs 
for the same job, and timing comparisons of the job flow would not be valid. 

8. If an installation checks job card accounting in the IEFUJV exit for all tasks, the 
IEFUJSV exit should not be taken, unless modified, for started tasks. Started 
tasks do not have any job card accounting and might be cancelled by the user 
exit.. 





Parameters 


At entry to the IEFUJV exit routine, register 1 points to a list of four-byte addresses, Jd 
as follows: 


1. The address of the common exit parameter area. (See Figure 4-4). 


2. The address of an 80-character JCL statement image (in EBCDIC). (JCL 
statements are identical to those listed in the SYSOUT data set; control 
statements containing only comments and resolved values for symbolic parameters, 
however, are not made available to this exit routine.) 


3. The address of a one-byte area that indicates the type of JCL statement being 
passed to this exit routine. The indicator will be a binary value, as follows: 


indicates a null statement. 
indicates a JOB statement. 
indicates an EXEC statement. 


indicates a DD statement. 

8 indicates a PROC statement. 

16 indicates all JCL has been converted. 

32 indicates a JDT (JCL definition table) defined verb. 

64 indicates that JDT defined JCL appears on this statement. 


& N— © 
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4. The address of the JES initialization parameters that are passed to the converter 
routine. The address points to the first converter parameter field. The field is 
a one-byte binary number that can have one of the following meanings when set: 


QO No account number or programmer name required. 

1 Programmer name required but not account number. 
2 Account number required but not programmer name. 
3 Account number and programmer name required. 


Note: The account number must not be required in the exit for started task 
JOB cards because there is no way to put an account number on a started task 
JOB card. An accounting number can be required on an EXEC card in 
SYS1-PROCLIB. 


Return Codes 


IEFUSI — 


Before the IEFUJV exit routine returns to the control program, it must place a 
return code in register 15, as follows: 


Q indicates job processing should be continued. 


4 indicates job processing should be canceled. 


Job Initiation Exit 


IEFUIJI receives control when the initiator selects a job on the input queue for 
initiation. A user-written IEFUJI exit routine could validate job accounting 
information or write to a user data set. It could also determine how long a job 

was on the input job queue before the initiator selected it. If the System Availability 
Management (SAM) Function is active and operational, SMF calls the SAM job/step 
initialization exit routine, AMSUJI, before it calls IEFUJI. IEFSMFIE then uses 
SMFEXIT to call the SMF job start user exit, IEFUJI. 


Notes: 

1. If an installation uses major and minor account numbers with several fields, this 
exit routine is easier to use than IEFUJV for account number processing because 
the accounting fields are placed in a formatted list. Figure 4-5 shows the format 
of the JOB statement accounting information that is available to IEFUSI. 


Offsets 
Dec. Hex. Length Format Description 
0 0 1 binary Number of accounting fields. 
1 1 variable EBCDIC Accounting fields. Each entry for an accounting 


field contains the length of the field (one byte, 
binary) followed by the field (EBCDIC). A zero 
indicates an omitted field. 





Figure 4-5. Format of Accounting Information Passed to IEFUJI and IEFUSI 


2. At job step or job termination, use the termination indicators in record types 4, 
5, 30, 34 and 35 to determine whether IEFUJI canceled the job. 


3. To use installation-defined data sets with this exit routine, you must define them 
with a DD statement in the initiator cataloged procedure. 
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Parameters 


At entry to the IEFUJI exit routine, register 1 points to a list of four-byte addresses 
as follows: 


1. The address of the common exit parameter area. (See Figure 44.) 


2. The address of a 20-byte area containing the programmer’s name (in EBCDIC) 
from the JOB statement. This area is aligned left and padded with blanks if 
necessary. 


3. The address of a one-byte area indicating (in binary) the requested job 
selection priority. This field equals the user-assigned priority of 0 to 14 
(taken from the PRTY parameter on the JOB statement). 


4. The address of an area containing the accounting information from the JOB 
statement. (See Figure 4-5.) 


Return Codes 


Before the IEFUJI exit routine returns control to the contro] program, it must place 
a return code in register 15, as follows: 
Q indicates job processing should be continued. 


4 indicates job processing should be canceled. 
IEFUSI — Step Initiation Exit 


IEFUSI receives control before the initiator starts each job step. A user-written 
IEFUSI exit routine could: 


e Validate job step accounting information 
e Write to a user data set 


e For long-running jobs, create a user step-initiation record in the case of 
system failure 


e Set region size and GETMAIN limit defaults for all applications. For more 
information on using IEFUS] to limit the region size, see System Modifications. 


Notes: 

1. If an installation uses major and minor account numbers with several fields, this 
exit routine is easier to use than IEFUJV for account number processing because 
the accounting fields are placed in a formatted list. Figure 4-5 shows the format 
of the EXEC statement accounting information that is available to IEFUSI. 


2. At job or job step termination, use the termination indicators in record types 4, 
5,30, 34 and 35 to determine whether IEFUSI canceled the job. 


3. To use installation-defined data sets with this exit routine, you must define them 
with a DD statement in the initiator cataloged procedure. 


4. If region requested by a job is greater than 16 megabytes, 32 megabytes will be the 
minimum region established by VSM. The IEFUSI cannot override the 32 
megabyte minimum value set by VSM. 
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Parameters 


At entry to the IEFUSI exit routine, register 1 points to a list of four-byte addresses, 
as follows: 


1. The address of the common exit parameter area. (See Figure 4-4). 


2. The address of an eight-byte area containing the job step name (in EBCDIC) 
from the EXEC statement. This area is aligned left and padded with blanks if 
necessary. 

3. The address of an eight-byte area containing the program name (in EBCDIC) 
from the EXEC statement. This area is aligned left and padded with blanks if 
necessary. If you use a refer back, the area contains “pgm=*.DD”. 


4. The address of an area containing the accounting information from the EXEC 
statement. (See Figure 4-5.) 


5. The address of a six-word area containing region limit values. (See Figure 4-6.) 


6. The address of a word containing a flag indicating a V=R job. (See Figure 46.) 


Return Codes 


Before the IEFUSI exit routine returns control to the control program, it must 
place a return code in register 15, as follows: 


Q indicates job processing should be continued. 


4 indicates job processing should be canceled. 
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Register 1 





Common SMF exit parameter area Flag word (initialized to 0) 


| 


© 
i 
KJ KJ 
NO NO 


Job step name (from EXEC 4 Region size requested 
statement) 8 
GETMAIN limit value below 16 
f Program name (from EXEC megabytes 
statement) 12 


Region size below 16 megabytes 
Step accounting information 


16) GETMAIN limit value above 16 


VSM parameter list megabytes 


SRM information fullword 20 


Region size above 16 megabytes 


Reserved 





' The VSM ffag word contains: 
Bit Meaning 
0 on= _ |EFUSI has set region limit values. 


NOTE: If GETMAIN limits are not set by the exit, but a check for 
contiguous free space by VSM should be performed, Bit 0 of the VSM 
flag word must be set. 
1 on= VSM is not to check for the availability of the requested amount 
of contiguous free space below 16 megabytes. wa 
off = VSM is to check for the availability of the requested amount of 
contiguous free space below 16 megabytes. 
NOTE: VSM tests this bit only when the REGION value is less than 
16 megabytes. 
2 on= VSM is to check for the availability of the requested amount of 
contiguous free space above 16 megabytes. 
off = VSM is not to check for the availability of the requested amount 
of contiguous free space above 16 megabytes. 
NOTE: VSM tests this bit only when the REGION value is greater than 
16 megabytes. 
3-31 Reserved 
NOTE: Because of compatability considerations for previous MVS/XA 
releases, the settings for bits 1 and 2 have opposite meanings. In pre- 
vious releases, VSM made no checks for free space above sixteen Mmega- 
bytes. Now, if the amount of contiguous free space requested is critical 
for the step to be executed, bit 2 must be turned on. 


2 On every entry to IEFUSI, the last four words in the VSM parameter list are set to 
X'FFFFFFFF’, 


Ww 


| 


The SRM flag word is received 


Figure 4-6. I[EFUSI Input Parameter Structure 
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IEFUTL — Time Limit Exit 


JEFUTL receives control from the timer second level interrupt handler when one of 
the following time limits expires: 


The job CPU time limit (from the JOB statement). 


The step CPU time limit (from the EXEC statement or the default from the job 
entry subsystem). 


The continuous wait time limit for the job (from the SMFPRMxx JWT parameter). 


A user-written IEFUTL exit routine could do any of the following: 

Cancel a job. 

Inform the operator that a job has exceeded its continuous-wait-time limit. 
Extend CPU time limits for selected jobs. 

Extend wait time limit within a job. 

Keep a record of time limit expirations. 


Vary the handling of time limit expirations for different types of jobs, such as 
teleprocessing, test, or production jobs. 


In addition to interval accounting and the expiration of MAXDORM, the exit 
can collect information at fixed intervals for long-running jobs to prevent loss of 
data in case of system failure. (See Note 1 for more information on testing a 
resource’s availability before issuing an SMFWTM or SVC.) 


Notes: 


1. 


A system interlock occurs anytime IEFUTL enqueues on a resource already 
enqueued on by the job step task or any of its subtasks. (More specifically, the 
initiator abnormally terminates if [EFUTL enqueues on such a resource because 
the asynchronous exit interface routine sets a “step must complete” status 
before IEFUTL receives control.) The enqueue can be explicit (for example, 
issue ENQSVC in exit IEFUTL) or implicit (the enqueue is done by an SVC 
that was issued by IEFUTL). An interlock also occurs if IEFUTL issues a TGET 
or a TPUT when the session manager is active during a TSO session. 


In any case, you can try to minimize the possibility of an interlock by first 
determining the resources used before the SVC or TSO macros were issued. Issue 
an ENQ macro specifying (1) the major and minor resource names in the 
QNAME and RNAME parameters, and (2) the RET=TEST parameter, as follows: 


ENQ(QNAME,RNAME,E,3(SYSTEM),RET=TEST MF=(E,CNTLADDR) 


Because SMF exits must be reentrant, be sure to use the execute form of the 
macro. 


For more information on the ENQ macro instruction, see System Macros and 
Facilifies. 


Chapter 4: Part I — User-Written Routines 4-15 


2. A user-written IEFUTL exit routine should control the number of extensions 
for a given step to prevent looping. It can record the expiration in the SMF 
data set or write a message to the console, however, in doing so, a system 
interlock could occur. (See Note 1.) To record the expiration in installation- 
defined data sets, you must define the data sets with a DD statement in the 
initiator cataloged procedure. 


3. CPU time is collected in two categories: execution under TCBs and execution 
under SRBs. The limiting function and the JEFUTL exit interfaces apply 
only to TCB time. 


4. Ifajob time limit is not specified on the JOB statement, the time limit for each 
job step is the value specified for the TIME= parameter on the EXEC statement, 
or the default value from the job entry subsystem. 


If a job time limit is specified on the JOB statement, the time limit for each job 
step is the remaining job time or the job step time limit (from the TIME= 
parameter or the job entry subsystem default), whichever is smaller. 


5. You can extend execution and wait time only within a step. Each extension resets 
the limit for the entire step to the extension value. If the step does not use all of 


the extended execution time, the time is not carried over for the next step. 


6. The wait time limit extension value replaces the previous wait time limit for 
the step. 


7. The smallest time extension granted is 220 microseconds or 1.048576 seconds. 


8. The CPU time-used field is checked each time a task status is saved, to determine 
if the specifjed time limit has been exceeded. 


Parameters 


At entry to the IEFUTL exit routine, register | points to the four-byte address of 
the common exit parameter area. (See Figure 4-4.) Register O will have a binary 


value, as follows: 


QO indicates the job CPU time limit expired. 
4 indicates the step CPU time limit expired. 


8 indicates the continuous wait time limit for the job expired. 


Return Codes 


Before the IEFUTL exit routines returns control to the control program, it must 
place a return cdde in register 15, as follows: 


QO indicates job processing is tq be canceled. 
4 indicates job processing is to be continued with a time extension in timer units. 


8 indicates job processing is to be continued with a time extension in seconds. 


You must place the time extension in register 1 ; you can determine the number 
of timer units by the algorithm: 


l1 second = 38400 timer units. 
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IEFUSO — SYSOUT Limit Exit 


Parameters 


IEFUSO receives control from the job entry subsystem when the number of records 
written to an output data set exceeds the output limit for that dataset. If the output 
limit is exceeded and an IEFUSO exit routine is not supplied, the job entry subsystem 
cancels the job. To specify the output limit, use the OUTLIM parameter on the DD 
statement defining the output data set. Note that the OUTLIM parameter limits output 
only to spooled data sets. This parameter is described in JCL. 


A user-written IEFUSO exit routine could: 
e Cancel a job that exceeds its output limit. 


e Inform the operator when a job exceeds its output limit and let the job continue 
processing. 


e Extend output limits for selected jobs. 


e Keep a record of jobs that exceed output limits. 


Notes: 


1. If IEFUSO indicates that the output limit is to be increased (register 15=4) but 
you do not increase the limit (register 1=0), the exit routine will receive 
control again when the next record is written to the output data set. 


2. The IEFUSO exit routine cannot access installation-defined data sets. 


At entry to the IEFUSO exit routine, register | points to the four-byte address of 
the common exit parameter area. (See Figure 4-4.) 


Return Codes 


Before the IEFUSO exit routine returns control to the control] program, it must 
place a return code in register 15, as follows: 


4 indicates job step processing is to be continued and the output limit is to be 
increased by the value placed in register 1. 
A value other than 4 indicates job step processing is to be canceled. 


IEFU83 — SMF Record Exit 


IEFU83 receives control before the SVC 83 routine buffers each record. This exit 
routine does not receive control for records whose writing has been suppressed either 
because of a system failure or because of options selected at IPLtime. A user-written 
IEFU83 exit routine could: 


Select or suppress those records to be written to the SMF data set. For example, 
an installation with a large TSO account might want to suppress the SMF dynamic 
DD records (type 40). 


Check resource usage during a specific interval. For example, select records during 
the peak workload period. 
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Notes: 

1. The [IEFU83 exit routines access installation-defined data sets. Also, it 
cannot issue the SMFWIM or SMFEWTM macro instruction to write to the 
SMF data set. 


2. The addresses of the user-communication and user-identification fields of the 
common exit parameterarea are not passed to the IEFU83 exit routine. (To 
obtain these addresses, the exit routine could follow the pointers to the 
TCTJMR field via the TCB plus X‘A4’.) 


3. If TEFU83 abnormally terminates, SMF, in most cases, does not terminate. 
SMF marks the exit as invalid and issues message [EE952I to the operator. If 
the exit performs a critical function, the operator can issue a SET SMF or 
SETSMF command to terminate recording. Otherwise, recording continues, 
but SMF does not invoke the exit. 


Parameters 


At entry to the IEFU83 exit routine, register 1 points to the four-byte address of 
the record descriptor word (RDW) of the SMF record to be written. 


Return Codes 


Before the IEFU83 exit routine returns control to the control program, it must 
place a return code in register 15, as follows: 


Q indicates the record is to be written to the SMF data set. 
4 indicates the record is not to be written to the SMF data set. 


JEFU84 — SMF Record Exit 


IEFU84 receives control before the branch entered SMF writer (SMFEWTM 
BRANCH=YES) routine buffers each record. The routine may be running 
locked or in SRB mode. This exit routine does not receive control for records 
whose writing has been suppressed because of options selected at IPL time. A 
user-written IEFU84 exit routine could: 


e@ Select or suppress those records to be written to the SMF data set. For example, 
an installation with a large TSO account might want to suppress SMF records for 
all but a few selected TSO users. 


e Check resource usage during a specific interval. For example, select records 
during the peak workload period. 


e@ Suppress some of the record type 30 subtypes. 
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Notes: 
1. The IEFU84 exit routine cannot access installation-defined data sets. Also, it 


cannot use the SMFWTM or SMFEWTM macro instruction to write to the SMF 
data set. 


2. Since [EFU84 may be locked or in SRB mode, the exit routine cannot issue any 
SVCs. IEFU83 may be given the alias name IEFU84, if IEFU83 can run locked 
or SRB mode. 


3. The addresses of the user-communication and user-identification fields of the 
common exit parameter area are nor passed to the IEFU84 exit routine. (To 
obtain these addresses, the exit routine could follow the pointers to the 
TCTJMR field via the TCB plus X‘A4’.) 


4. If IEFU8&4 abnormally terminates, SMF, in most cases, does not terminate. 
SMF marks the exit as invalid and issues message IEE952I to the operator. If 
the exit performs a critical function, the operator can issue a SET SMF or 
SETSMF command to terminate recording. Otherwise, recording continues, but 
SMF does not invoke the exit. 


5. [EFU84 is called from the SMF address space rather than the master scheduler 
address space at system initialization (IPL) for record types 0, 8, 19, 22, and 90. 
Therefore, if IEFU84 references data in the master scheduler private area, 
which is no longer available, for record types 0, 8, 19, 22, and 90, you must 


modify the exit. Use cross memory instructions (SSAR, MVCP, and MVCS) to 
move data between the two address spaces. 
Parameters 


At entry to the IEFU84 exit routine, register 1 points to the four-byte address of 
the record descriptor word (RDW) of the SMF record to be written. 


Retum Codes 


Before the IEFU84 exit routine returns control to the control program, it must 
place a return code in register 15, as follows: 
O indicates the record is to be written to the SMF data set. 


4 indicates the record is not to be written to the SMF data set. 
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JEFACTRT — Termination Exit 


IEFACTRT receives control from the terminator when each job or job step 
normally or abnormally terminates. If the System Availability Management (SAM) 
Function is active and operational, SMF calls the SAM job/step termination exit 
routine, AMSACT, before it calls IEFACTRT. A user-written IEFACTRT exit 
routine could perform various functions that are unique to an installation’s 
requirements. For example, the routine could: 


@ Write selected job/step records to an installation-defined data set for further 
analysis. 


@ Include additional information in the SMF job/step termination records. 


@ Write messages to SYSOUT to provide additional information about the job/step. 
For example, if the operator canceled the job, issue a WTOR to learn why the 
job was canceled, and then write the reason as a message to SYSOUT. 


e@ Write an estimated job/step cost to SYSOUT. 


e Update tables that describe the amount of resources allowed to certain users. 
For example, keep a total of the CPU time used by specific users and flag their 
account numbers if they exceed their allowed time limit. 


Notes: 

1. IEFACTRT is the only exit routine than can write to the system output message 
data set, and only by passing a message to module IEFYS. If a user-written 
IEFACTRT exit routine writes messages for system output, the contents of 
register 12 must be the same as when the routine received control, and register 13 
must contain the address of an 18-word work area. Figure 4-7 shows the procedure 
to use when writing system output messages from IEFACTRT. Note that the 
maximum number of characters printed on one line is 132. 


MVC 36(4,12), MSGADDR MOVE MESSAGE ADDRESS AND 
MVC 42(2,12),.MSGLEN LENGTH TO SYSTEM TABLE 
L REG15,VIEFYS BRANCH AND LINK TO MESSAGE 
BALR REG14,REG15 ROUTINE 

MSGADDR DC A(MSG) 

MSG DC C’message text’ 

MSGLEN DC H’xx’ MESSAGE LENGTH? 

VIEFYS DC V(IEFYS) 





1The message will be truncated to 132 characters if necessary. 
Figure 4-7. Writing System Output Messages from IEFACTRT 


2. IEFACTRT can direct output to the console or to the system output device. It 
can also write to the SMF data set or to an installation-defined data set. To use 
installation-defined data sets with this exit routine, you must define them with 
a DD statement in the initiator cataloged procedure. 


3. At job step or job termination, use the termination indicators in record types 4, 
5, and 30, to determine whether IEFACTRT canceled the job. 


4. If the type 30 record exceeds 32,756 bytes and is split additional type 30 
records are produced, and IEFACTRT is also entered for each of these records. 
See ‘Notes’ under the description of record 30 for more information concerning 
maximum length. 
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Parameters 


At entry to the IEFACTRT exit routine, register 1 points to a list of four-byte 
addresses, as follows: 


1. The address of the common exit parameter area. (See Figure 4-4.) 


10. 


Return Codes 


. The address of an eight-byte area containing the job step name (in EBCDIC). 


This area is aligned left and padded with blanks if necessary. At job termination, 
the address is zero. 


. The address of a 20-byte area containing the programmer’s name (in EBCDIC). 


This area is aligned left and padded with blanks if necessary. 


. The address of a four-byte area whose first three bytes contain the job CPU time 


under TCBs, in hundredths of a second (in binary), and whose last byte contains 
the number of accounting fields in the JOB statement (in binary). 


. The address of an area that contains accounting information from the JOB 


statement. This area has the format described earlier in Figure 4-5, excluding the 
first field shown (the number of accounting fields). 


. The address of a four-byte area whose first three bytes contain the step CPU time 


under TCBs, in hundredths of a second (in binary), and whose last byte contains 
the number of accounting fields in the EXEC statement (in binary). At job 
termination, the address is zero. 


. The address of an area that contains accounting information from the EXEC 


statement. This area has the format described earlier in Figure 4-5, excluding the 
first field shown (the number of accounting fields). At job termination, the 
address is zero. 


. The address of a two-byte area. The first byte is an indicator: if bit 7 is set to 1 


when the exit routine is entered, the job has been canceled; if the exit routine 
sets bit 7 to 1, the job will be canceled. The second byte contains the number of 
the job step currently being processed. At job termination, the second byte 
contains the number of steps in the job. 


. The address of a two-byte area containing the termination status (condition or 


completion code) of the job or job step. 


The address of an area containing a four-byte record descriptor word (RDW) 
immediately followed by the job step termination record (type 4 or 34) or the 
job termination record (type 5 or 35) or the common address space work 
record (type 30), or the TSO command counting record (type 32) to be 
written to the SMF data set. 


At entry to the [EFACTRT exit routine, register 0 contains a binary code 


indicating the reason for entry, as follows: 


12 indicates job step termination. 


16 indicates job termination. 


20 indicates job or step termination. The tenth parameter is the address of the 


RDW for a type 30 record. The subtype field in the record determines if it 
is a job or step termination record. 


24 ‘indicates that the tenth parameter is the address of the RDW for a type 32 


record. 
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Return Codes ; 


Before the IEFACTRT exit routine returns control to the control program, it must 
place return codes in registers 1 and 15, as follows: 


e@ In register 1: 


4 indicates the termination record is not to be written to the 
SMF data set. 

A value other than 4 indicates the termination record is to be written to the 
SMF data set. 


e In register 15: 
4 indicates the remaining job steps are to be canceled. 


A value other than 4 indicates job processing is to be continued. 


IEFUJP — Job Purge Exit 


IEFUJP receives control when a job entry subsystem is ready to purge a job from 
the system, that is, after a job has terminated and the system has written all the 
SYSOUT output that pertains to the job. A user-written IEFUJP exit routine 
could use the SMF job purge record (type 26) to summarize a job’s activities in 
the system. 


Note: To use installation-defined data sets with this exit routine, you must define 
them with a DD statement in the job entry subsystem cataloged procedure. 


Parameters 


At entry to the IEFUJP exit routine. register 1 points to a list of four-byte addresses, 
as follows: 


1, The address of the common exit parameter area. (See Figure 4-4.) 


2. The address of an area containing the job purge record (type 26) to be written to 
the SMF data set. 


Return Codes 
Before the IEFUJP exit routine returns control to the control program, it must 


place a return code in register 15, as follows: 


4 indicates the job purge record is not to be written to the 
SMF data set. 


A value other than 4 indicates the job purge record is to be written to the SMF 
data set. 
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TEFU29 — SMF Dump Exit 


TEEMB8729 calls IEFU29 whenever a SMF data set requires dumping. Some 
examples are: 


e During SMF initialization for alternate data sets that are not empty. 
@ During SWITCH SMF command processing fora data set that is not yet full. 
e During SMF processing when a data set becomes full. 


A user-written IEFU29 exit routine can issue a WTO macro instruction re- 
questing the operator to start the dump program or can initiate the dump program 
by submitting a job request to an internal reader. For more information on sub- 
mitting a job request to an internal reader, see System Modifications. 


Note: IEFU29 runs in the SMF address space. If an existing exit routine 
references data that exists in the private area of the master scheduler address 
space, you must modify the exit. Use cross memory instructions (SSAR, 
MVCP, and MVCS) to move data between the two address spaces. 


Parameters 


At entry to the IEFU29 exit routine, register 1 points to the four-byte address of 
the ten character data set name of the SMF data set to be dumped. 


Return Codes 


Before the IEFU29 exit routine returns control to the control program, it must 
place a return code in register 15. A return code of 4 indicates that the dump 
message, IEE3621 or IEE362A, is to be suppressed. A value other than 4 indicates 
that the dump message, JEE362] or IEE362A, is to be issued. 
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Part II — Testing Exit Routines 


Part IJ describes one method of testing user-written exit routines, the TESTEXIT 
procedure in SYS1.ASAMPLIB. This procedure contains an assembler language 
source program (also named TESTEXIT) which attaches the data generator utility 
program (IEBDG) to create sample parameter lists for all user-written exit 
routines except IEFU29. (The TESTEXIT procedure creates the parameter list for 
the IEFU29 exit routine without using the data generator utility program.) The 
source program then calls each user-written exit routine being tested, and passes the 
appropriate parameter list to it. Figure 4-8 illustrates the input/output and control 
flow of the TESTEXIT source program. 





Figure 4-8. TESTEXIT Input/Output and Control Flow 


Before using the TESTEXIT procedure: 


|. Fulfill the following user-written exit routine testing requirements: 


e Specify a user subpoo! (0-127) in all GETMAIN macro instructions included 
in the routines. 
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e@ Provide a special SMFWTM macro instruction in all routines that use the macro. 
e Place the routines in a partitioned data set. 
2. Obtain the TESTEXIT procedure from SYS1-ASAMPLIB. 


3. Modify the procedure to meet the installation’s testing requirements. 


TESTEXIT Exit Routine Requirements 


Before using the TESTEXIT procedure, fulfill the following exit routine 
requirements: 


e Specify a user subpool (0-127) in all GETMAIN macro instructions included in 
your routines. When testing is completed, specify one of the subpools shown in 
Figure 4-14 for the area used to communicate between exit routines (see Part II], 
‘Obtaining Additional Work Areas’’). 


e Provide a special SMFWTM macro instruction in all exit routines that use the 
macro. The special macro definition writes to the TESTEXIT data set defined by 
the DD statement named MANX. (With the normal SMFWTM macro instruction, 
the data is written to the active SMF data set.) Using this macro definition, then, 
data is processed without accessing the system data on the active SMF data set. 
When testing is completed, remove the macro definition. Figure 4-9 shows the 
SMFWIM macro instruction that is required for using the TEXTEXIT procedure. 


MACRO 
&NAME SMFWIM &MSGAD 
AIF (‘&MSGAD’ EQ’’). E1 
AIF ("&MSGAD’‘ EQ“ (1)’) . BAL 
AIF (‘'&MSGAD‘ (1,1) EQ ‘("). REGA 
AGO .LODIT 
-E1 MNOTE 7°°* NO OPERAND SPECIFIED °°°’ 
MEXIT 
BAL ANOP 
CNOP 0,4 
&NAME BAL 15,°+8 
-LIST DC V(TSMFWTM) 
L 15,0(15) 
BALR 14,15 
MEXIT 
-REGA ANOP 
&NAME LR 1,&MSGAD(1) 
CNOP 0,4 
BAL 15,°+8 
AGO LIST 
.LODIT ANOP 
&NAME LA 14&MSGAD 
CNOP 0,4 
BAL 15,°+8 
AGO LIST 
MEND 


Figure 4-9. SMFWTM Macro Definitions Required for Using TESTEXIT 


e Place the exit routines in a partitioned data set named EXITLIB. Figure 4-10 
shows sample JCL for entering the routines into EXITLIB. 
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Tg 


//UPDTE JOB MSGLEVEL=1 


// EXEC PGM=IEBUPDTE,PARM=NEW 
IISYSUT2 DD DSNAME=EXITLIB,VOLUME#SER=231400, 
I UNIT=3350,SPACE=(TRK,(10,3,1)),DISP=(,KEEP), . 
// OCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
//SYSPRINT DD SYSOUT#A 

IISYSIN DOD DATA 

/ AOD NAME=IEFUJV 

(IEFUJV object deck) 

/ AOD NAMESi/iEFUJI 

(IEFUJI object deck) 

/| AOD NAME=IEFUSI 

(JEFUSI object deck) 

/ ADD NAMEIEFUTL 

(JEFUTL object deck) 

/ .ADD NAME=IEFUSO 

(JEFUSO object deck) 

/ ADD NAMEIEFU83 

(JIEFUS83 object deck) 

| AOD NAME2IEFACTRT 

(IEFACTRT object deck) 

| AOD NAME=IEFUJP 

(JEFUJP object deck) 

/ AOD NAME=!(EFU29 

(IEFU29 object deck) 

. ADD NAME=|EFU84 

(JEFU84 object deck) 

/ ENOUP 

/* 


Figure 4-10. Sample JCL for Entering User-Written Exit Routines into EXITLIB 


Obtaining TESTEXIT from SYS1.ASAMPLIB 


Figure 4-11 shows sample JCL for obtaining a punched deck of TESTEXIT from 
SYS1.ASAMPLIB. 





//PUNCH JOB MSGLEVEL=1 

II EXEC PGM=1EBPTPCH 

/ISYSPRINT DD SYSOUT=A 

/ISYSUT1 DD DSNAME=SYS1.ASAMPLIB,DISP=(OLD,KEEP), 
I UNIT=xxxx,VOLUME=SER=xxxxxxt 

/ISYSUT2 DD UNIT=2540-2 

/ISYSIN DD * 


PUNCH TYPORG=P0 ,MAXNAME=1,MAXFLDS=1 
MEMBER NAME=TESTEXIT 
RECORD FIELD=(80) 

/* 





1The volume and unit parameters depend on your installation’s request. 


Figure 4-11. Sample JCL for Obtaining a Punched Deck of TESTEXIT 
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Modifying the TESTEXIT Procedure 





Figure 4-12 shows sample JCL for executing the TESTEXIT procedure. 





/{TESTEXIT JOB MSGLEVEL=1 

/{TEST EXEC ASMFCL 

//ASM.SYSIN DD * 

(TESTEXIT Source Module) 

ied 

//LKED.SYSLMOD DD DSNAME=TESTLIB,VOLUME=SER=335000, 
i UNIT=3350,SPACE=(TRK,(5,2,1)), 

il DISP=(NEW,KEEP) 

//LKED.EXITS DD DSNAME=EXITLIB,VOLUME=SER=335000, 
i UNIT=3350,DISP=OLD 


//LKED.SYSIN DD * 
INCLUDE EXITS(IEFUJV,EFUJI,IEFUSI,IEFUTL,IEFUSO, 
IEFU83,IEFACTRT ,JEFUJP,IEFU29, IE FU84) 
ENTRY TESTEXIT 
NAME TESTEXIT 
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et 
//DATAGEN JOB MSGLEVEL=1 
i EXEC PGM=IEBGENER 
IISYSUT2 DD DSNAME=DGINPUT,UNIT=3350,DISP=(,KEEP), 
il VOLUME=SER=335000 SPACE=(TRK,(10,5,1)), 
Il DCB=(LRECL=80,BLKSiZE=400,RECFM=FB) 
//SY SPRINT DD SYSOUT=A 
I/SYSIN DD * DLM=XX 
GENERATE MAXNAME#9,MAXGPS=0 
MEMBER NAME=UJV 
RECORD IDENT=(6,’ENDUJV’,1) 
MEMBER NAME=UJI 
RECORD IDENT=(6,’,ENOUJI',1) 
MEMBER NAME=USI 
RECORD IDENT=(6,’ENDUS\’,1) 
MEMBER NAME#UTL 
RECORD IDENT=(6,,/ENDUTL’,1) 
MEMBER NAME=U83 
RECORD IDENT=(6,’ENDU83’,1) 
MEMBER NAME=ACT 
RECORD IDENT=(6,’,ENDACT’,1) 
MEMBER NAME=USO 
RECORD iIDENT=(6,,ENDUSO’,1) 
MEMBER NAME=UJP 
RECORD 1DENT=(6,,ENDUJP’,1) 
MEMBER NAME=U84 
RECORD IDENT=(6,’ENDOU84',1) 
XX 
//SYSUT1 DD DATA,DLM=YY 
DSD OUTPUT=(OUTUJV) 
(IEBDG Control Statements for IEFUJV) 
ENDUJV END 
DSD OUTPUT=(OUT UJI) 
(IEBDG Control Statements for |E FUJI) 
ENDUJI END 


SSS SaaS a a 


DSD OUTPUT=(OUTUSI) 
(1IEBDG Control Statements for IEFUSI} 


Figure 4-12, Sample JCL for Executing TESTEXIT (Part 1 of 3) 
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ENDUSI 


ENDUTL 


ENDU83 


ENDACT 


ENDUSO 


ENDUJP 


ENDU&S4 
YY 


/TTESTING 
//JOBLIB 


// 
// 


END 

DSD OUTPUT=(OUTUTL) 

(1EBDG Control Statements for IEFUTL) 
END 

DSD OUTPUT=(OUTU83) 

(1EBDG Control Statements for [EFU83) 
END 

DSD OUTPUT=(OUTACT) 

(1EBDG Control Statements for IEFACTRT) 
END 

DSD OUTPUT=(OUTUSO) 

(1EBDG Control Statements for |EFUSO) 
END 

DSD OUTPUT=(OUTUJP) 

(1EBDG Control Statements for |EFUJP) 
END 

DSD OUTPUT=(OUTU84) 

(1EBDG Control Statements for [IEFU84) 
END 


JOB MSGLEVEL=1 

DD DSNAME=TESTLIB,VOLUME=SER=335000, 
UNIT=3350,DISP=(OLD,KEEP) 

EXEC PGM=TESTEXIT, 


// PARM='UJV=25,UJ1I=8,USI=8, USO=5, UTL=5,U83=12 ACT=2,UJP=2 ,U29=2,U84=12' 


/HINUJV 
// 

// 
//INUJI 
// 

// 
//INUSI 
// 

// 
//INUSO 
// 

// 
/IINUTL 
// 

// 
//INU83 
// 

// 
/IINACT 
// 

// 
//\NUJP 
// 

// 
/IINU84 
// 

// 


DD DSNAME=DGINPUT(UJV),DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=3350,VOLUME=SER=335000 

DD DSNAME=DGINPUT(UJI),OCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=3350, VOLUME=SER=335000 

DD DSNAME=DGINPUT(USI) ,DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=3350,VOLUME=SER=335000 

DD DSNAME=DGINPUT(USO),DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=3350,VOLUME=SER=335000 

DD DSNAME=DGINPUT(UTL),DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=3350, VOLUME=SER=335000 

DD DSNAME=DGINPUT(U83) ,.DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB) DISP=(OLD,PASS), 
UNIT=3350,VOLUME=SER=335000 

DD DSNAME=DGINPUT(ACT),DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=3350,VOLUME=SER=335000 

DD DSNAME=DGINPUT(UJP),DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=3350, VOLUME=SER=335000 

DD DSNAME=DGINPUT(U84),DCB=(LRECL=80, 
BLKSIZE=400,RECFM=FB),DISP=(OLD,PASS), 
UNIT=3350,VOLUME=SER=335000 





Figure 4-12. Sample JCL for Executing TESTEXIT (Part 2 of 3) 
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Dll 


//OUTUJV DD DSNAME=UJV(OUT),UNIT=3350,DISP=(,PASS), 
i SPACE=(TRK,(10,5,1)), VOLUME=SER=335000, 

iT OCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
H/OUTUSI DD DSNAME=UJI(OUT),UNIT=3350,DISP=(,PASS), 
iT SPACE=(TRK,(10,5,1)), VOLUME=SER=335000, 

iT OCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
//OUTUSI DD DSNAME=(USI(OUT),UNIT=3350,DISP=(,PASS), 
iT SPACE=(TRK,(10,5,1)), VOLUME=SER=335000, 

iT OCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
//OUTUSO DD DSNAME=(USO(OUT),UNIT=3350,DISP=(,PASS), 
Tl SPACE=(TRK(10,5,1)), VOLUME=SER=335000, 

i OCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
HOUTUTL DD DSNAME=UTL(OUT),UNIT=3350,DISP=(,PASS), 
i SPACE=(TRK,(10,5,1)}, VOLUME=SER=335000, 

i DCB=(LRECL=80,BLKSIZE=400,RECFM=FB) 
//OUTU83 DO DSNAME=U83(OUT),UNIT=3350,DISP=(,PASS), 
i SPACE=(TRK,(10,5,1)}), VOLUME=SER=335000, 

iT OCB=(LRECL=130,BLKSIZE=130,RECFM=FB) 
/IOUTACT DD DSNAME=ACT(OUT),UNIT=3350,DISP=(,PASS), 
iT SPACE=(TRK,(10,5,1)), VOLUME=SER=335000, 

i DC8=(LRECL=180,BLKSIZE=180,RECFM=FB) 
/IOUTUJP DD DSNAME=UJP(OUT),UNIT=3350,DISP=(,PASS), 
i SPACE=(TRK,(10,5,1)), VOLUME=SER=335000, 

iT DCB=(LRECL=130,BLKSIZE=130,RECFM=FB) 
//OUTU84 DD DSNAME=U84(OUT),UNIT=3350,DISP=(,PASS), 

i SPACE=(TRK,(10,5,1)), VOLUME=SER=335000, 

I DCB=(LRECL=130,BLKSIZE=130,RECFM=FB) 
/IMANX OD UNI|T=3350,VOLUME=SER=335000,DSN=MANX, 
iT SPACE=(TRK,(3,1)) DISP=(NEW,KEEP), 

i DCB=(BLKSIZE=200, LRECL=196) 

/ISYSPRINT DD SYSOUT=A,D0CB=(BLKSIZE#=136, LRECL=1 32) 
//(DGPRINT DD SYSOUT=A 

//SYSABEND DD SYSOUT=A 

/* 





Figure 4-12. Sample JCL for Executing TESTEXIT (Part 3 of 3) 


A summary of the operations performed by the procedure shown in Figure 4-12 


is as follows: 


The TESTEXIT job assembles the TESTEXIT source program (not illustrated in 
the figure) and link-edits it with the exit routines being tested. (Note that the 
exit routines must reside in EXITLIB, a partitioned data set.) 


The DATAGEN job, using the IEBGENER utility program, creates a partitioned 
data set (DGINPUT) containing control statements for the IEBDG utility program, 
which will be attached by the TESTEXIT source program. 


The TESTING job includes the execution of the TESTEXIT source program. 


Use the TESTEXIT procedure provided in SYS1.ASAMPLIB to link-edit the 





sample exit routines in SYS1.ASAMPLIB, generate sample parameter lists, and test 
the sample exit routines. To adapt the TESTEXIT procedure to your installation’s 
testing requirements, however, note the following modifications: 


e The TESTEXIT job shown in Figure 4-12 link-edits the TESTEXIT source 
program with the exit routines. The TESTEXIT procedure in SYS1.ASAMPLIB 
contains ten exit names in the INCLUDE statement. However, when you use 
the TESTEXIT procedure your INCLUDE statement should contain only the 
names of the exit routines you are testing. 
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@ The DATAGEN job shown in Figure 4-12 creates a partitioned data set containing 
the IEBDG control statements that generate samples of standard parameter lists. 
The TESTEXIT procedure contains the control statements for nine exits. Note 
that control statements are not required for the IEFU29 exit routine because the 
TESTEXIT procedure creates the parameters needed to test that routine. When 
using the TESTEXIT procedure you should include only those statements 
needed for the routine you are testing. When testing for special conditions or 
required additional test parameters, you must make appropriate modifications 
and additions to the control statements. 

Note that you must supply control statements in such an order that the records 
subsequently generated by the IEBDG utility program will be grouped as complete 
parameter lists that conform in length and format to the exit parameters previously 
defined in this chapter. (Be sure to include the entry code passed to exits IEFUTL 
and IEFACTRT in register 0 as a one-byte parameter at the end of the parameter 
lists for those exits.) For detailed information on the use of IEBDG control 
statements, see Ufilities. 


e@ The TESTING job shown in Figure 4-12 includes the execution of the TESTEXIT 
source program. Values for the PARM parameter of the EXEC statement specify 
which exit routines are to be tested and the number of times each is to be tested. 
The TESTEXIT procedure in SYS1.ASAMPLIB contains the parameters to test 
ten exits. However, when you use the TESTEXIT procedure you should include 
only the parameters for the routines you are testing. This parameter has the 
format: 


PARM®’xxx=nnn ,..., xxx=nnn’ 





where: 


XXX 
is an exit routine identifier. 


nnn 
is the number of times an exit routine is to be tested (the maximum value is 
255). 


The DD statements to be included depend upon the exit routines being tested. 
The TESTEXIT procedure contains DD statements for nine exits as shown in the 
sample (Figure 4-12). When you use the TESTEXIT procedure you should include 
only the DD statements for exits you are testing. DD statements are not required 
for the IEFU29 exit. Figure 4-13 shows the exit-routine identifiers, specified on the 
EXEC statement, and the DD statements that you must include for each exit 
routine being tested. 
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[Exit Routine | identifier | OD Statements 
[an | MANX, SYSPRINT, OGPRINT, SYSABEND 


Figure 4-13. Parameters and DD Statements for Executing TESTEXIT 


Note that you must include DD statements for any other data sets used by the exit 
routines in the JCL for the TESTEXIT procedure. 
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Part II] — Exit Routine Facilities 


Part III describes the facilities available to user-written exit routines. The following 
macro facilities are described later in Part III: 


IFASMFR 
SMFWTM 
SMFEWTM 
SMFRTEST 
SMFEXIT 
SMFINTVL 
SMFDETAL 
SMFSUBP 
SMFCHSUB 


Part III also details how user-written exit routines can communicate with each other 
and how to obtain additional work areas. For more information on the facilities that 
apply to a specific exit routine, see that exit routine described in Part I of this 
chapter. 


Communicating Between Exit Routines 


User-written exit routines can communicate with each other in two ways: by using 
the user-communication field or by using the user-identification field. Both of these 
fields are contained in the common exit parameter area, which is passed to all user- 
written exit routines except IEFU83, IEFU84, and IEFU29. 


All exit routines (except IEFU83, IEFU84, and IEFU29) that are executing within 
the same job can communicate via the user-communication field (displacement 32 in 
Figure 4-4) and the user-identification field (displacement 20 in Figure 4-4). Either 
data or the address of a data area can be placed in the communication field. How- 
ever, passing the address of a data area can cause a problem. For example, assume 
the user exit IEFUJV runs on the global processor with JES3. The exit issues a 
GETMAIN, and stores the address of the data area in the user communication 
field. Unless the related job runs on the same processor, it will terminate 
abnormally. The same problem can occur if a system restart occurs after IEFUJV 
sets the address but before the related job tries to use the address. Additionally, jobs 
that are requeued for execution or warm started through the $E command also contain 
invalid data. 


Notes: 


1. The user-communication field is initialized to zeros by the job entry subsystem 
each time a job begins execution; the user-identification field is initialized to 
EBCDIC blanks each time a job is read. Neither of these fields is maintained if the 


system is restarted. 


2. If there is communication between exits, use care in creating the SMF parmlib 
members; make sure that all exits involved are included in each member. 
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Obtaining Additional Work Areas 


Any user-written exit routine can obtain an additional work area by issuing a 
GETMAIN macro instruction that specifies an appropriate subpool. Figure 4-14 
shows the subpools (and their characteristics) that are required to obtain additional 
work areas. Be sure to consider the storage required by an additional work area 
when estimating the sizes of the common service area (CSA), system queue area 
(SQA), and local system queue area (LSQA). 


Subpool | Areain 
Number | Storage Attributes of Subpool 


Private 
Area 
Storage 


related) 





User protection key 
Pageable 
Fetch-protected 


User protection kay 
Pageable 
Not fetch-protected. 


Explicitly freed 

Pageable 

F etch-protected 
System-oriented 
User Key 


Explicitly freed 
Pageable 

Not fetch-protected 
System-oriented 
User key 


Explicitly freed 
Fixed 

Not fetch-protected 
Systen-oriented 
Key=0 


Automatically freed at end 
of task 

Fixed 

Not fetch-protected 

Job-oriented 

Key=0 

Swappable 


Automatically freed at end 
of step 

Fixed 

Not fetch-protected 

Job-oriented 

Key=0 

Swappable 

Explicitly freed 

Fixed 

Not fetch-protected 

Job-oriented 

Key=0 

Swappable 





Automatically freed at task 
termination. Assigned 
from top of private area. 


Automatically freed at task 
termination. Assigned 
from top of private area. 


Because subpool 231 is fetch- 
protected, usa it for exit 
communication only among exits of 
the same key (see Figure 4-3). 


Because SMF exit routines receive 
control in different keys (see 
Figure 4-3), and subpool 241 is not 
fetch-protected, usa it for read 
access from all exits. 


Allows a task running in key 0 to 
acguire non-accountable, fixed, 
protected storage that is systern- 
oriented. 


Allows a task running in key Oto 
acquire fixed, accountable, 
protected storage in the LSQA for 
the user’s region that is job-oriented 
and freed when the task terminates. 


Allows a task running in key 0 to 
acquire fixed, accountable, 
protected storage in the LSQA for 
the user’s region that is job-or ented 
and freed when the job step 
terminates. 


Allows a task running in key 0 to 
acquire fixed, non-accountable, 
protected storage in the LSQA that 
is job-oriented and must be 
explicitly freed. 


Figure 4-14. Required Subpools for Obtaining Additional Work Areas 
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Using the IFASMFR Macro to Address SMF Record Fields 


Use the IFASMFR macro instruction in user-written exit routines (or in any 
problem program application) to symbolically address SMF record fields. The 
macro instruction is written in assembler language and is supplied on 
SYS1.AMODGEN. Depending on your installation’s requirements, you may want 

to copy the IFASMFR macro from SYS1.AMODGEN into your own macro library 
or SYS1.MACLIB. Note that the IFASMFR macro is distributed as 14 submacros: 
IFASMFR, IFASMFR1, IFASMFR2,...IFASMFR9,IFASMFRA,... 
IFASMFRD. 


The format of the IFASMFR macro is: 





IFASMER n 





where: 
n 


is the record type to be defined. You must specify at least one record type 
with the macro; if more than one record type is specified, you must enclose 
the record types in parentheses and separate them by commas. The values 
for ncan be: 0, 2-11, 14, 15, 17-23, 24 (JES2 only), 25 (JES3 only), 26, 
30-32, 34, 35, 37, 40, 43, 45, 47-49, 52-59, 62-64, 67-74, 80-81, 90. For 
records not listed, see the description of the record in “SMF Records.” 


Notes: 

1. The “Name” column in all the SMF record formats (see the chapter “SMF 
Records’) contains the symbolic addresses defined by the IFASMFR macro 
instruction. 

. Do not specify both record type 14 and record type 15 in the same program. 
Because these records are identical, whenever record type 15 is specified in the 
IFASMFR macro, record type 14 is defined. 

. If you do not want the IFASMFR macro to use part of the problem program’s 
storage, then supply a CSECT or DSECT statement ahead of the macro 
instruction. (If you invoke the IFASMFR macro within a DSECT, multiple 
record types are mapped contiguously. That is, each record type will not have 
a zero origin). 

.. To address SMF record fields for record types 60, 61, 65, and 66, use the 
IFASMFI6 macro instruction instead of IFASMFR macro instruction. 

. To generate the JES SMF record mappings, IFASMFR invokes the IAZSMFR 
macro. Both IFASMFR and IAZSMFR should reside on macro libraries used in 
your SYSLIB concatenation. [AZSMFR is supplied on SYS1.MACLIB and is 
distributed as 14 submacros: I[AZSMF25, 26, 43, 45,47, 48,52... 58. 


NO 


iv) 


- 


wa 
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Using the SMFWTM Macro to Write Records 





Use the SMF WEM macro instruction to write records to the SMF data set. The 
address of each record to be written must be less than 16 megabytes. If the address 
is greater than 16 megabytes, the routine that issued SMFWIM abends with an 
X°353’ system completion code. You can use this macro in any exit routine that 
has a storage protect key of zero except IEFU83 and IEFU29 (see Figure 4-3), and 
in any installation problem program that has an APF authorization. The SMFWIM 
macro is written in assembler language and is supplied on SYS] .MACLIB. Its 
format is: 


[label] SMFWTM | record address | (r) } 


where: 
record address 
is the symbolic address of the record to be written. 
(7) 


is a register containing the address of the record to be written. The value 
for (r) can be either the absolute register number or a symbol for the 
register. In either case, you must code the parentheses, for example, (2) or 
(REG2). 


Record types 128 through 255 are available for user-written records. When using 
the SMFWTM macro instruction to write user records, you must provide the standard 
SMF record header, which includes a record descriptor word (RDW) for the record. 
You must also fill in the date, time, and system identifier in the record header. While 
the system identifier can be any four character identifier, specifying the SMCASID 
is consistent with the system records SMF produces. (Fora description of the 
standard SMF record header, see the chapter “SMF Records”’ in this book. Fora 
description of the RDW, see Data Management Services. } 





Record types 0 through 127 are SMF-formatted records. For all SMF-formatted 
records you must supply: 


e The RDW (offsets 1 and 2 in Figure 6-1 and 6-2) 
@ The record type field in the standard SMF record header (offset 5 in Figure 6-1 and 
Figure 6-2) 


The SMFWTM macro supplies the remaining header information. 


All SMF records are given to user exit [IEFU83 before they are written to the SMF 
data set. 


The SMFWTM macro instruction returns a code in register !5 that indicates the 
record’s status, as follows: 
@ O indicates the record was written without error. 


@ 8 indicates the record was not written because the length specified in the RDW 
was less than 18 bytes. 


e 16 indicates the record was not written because SMF is not active. 
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Using the SMFWTM Macro to Write Records (continued) 


e 20 indicates the record was not written because the user-written IEFU83 exit 
routine suppressed the record. 


e 24 indicates that the record was not written because the data was lost. 


e 36 indicates that the record was not written because the record specified is 
not currently being recorded. 


e 40 indicates that the record was not written because a buffer storage 
caused the data to be lost 


e 44 indicates that the record was not written because SVC 83 was unable to 
establish recovery. 


Using the SMFEWTM Macro to Write Records 


Use the SMFEWTM macro instruction to write records to the SMF data set. The 
address of each record to be written must be less than 16 megabytes. If the address 
is greater that 16 megabytes, the routine that issued SMFEWTM abends with an 
X‘353’ system completion code. You can use this macro in any exit routine that 

is in supervisor state except IEFU83, IEFU84, and IEFU29 (see Figure 15), and 

in any installation problem program that has APF authorization. The SMFEWTM 
macro verifies that SMF recording is active and allows the issuer to branch directly 
to the SVC routine without issuing the SVC. When you invoke SMFEWTM, the macro 
makes reference to two fields SMCAMACR and SMCABASE found in the SMCA con- 
trol block. Because SMF uses this control block as a major communication area, you 
can check these two SMCA fields to determine if SMF is active. The SMFEWTM 
macro is written in assembler language and is supplied on SYS] .MACLIB. Its format is: 


———— SS SSS SST 


[label] SMFEWTM [rec addr] ,BRANCH=NO 
;ARANCH=YES 


a 
———_ 


SUBSYS=name WRKAREA=addr 
SUBSYS=(reg) WRKAREA=(reg) 


eS er 


The parameters are: 


rec addr 
specifies the address or the register (2)-(12), that contains the address of the 
record to be written. 


,BRANCH=NO 

,BRANCH=YES 
specifies the entry method to the SVC routine. If BRANCH=NO is specified, 
the macro generates an SVC 83. If BRANCH=YES is specified, the macro 
generates a call to the subroutine that moves the data to the SMF buffer. To 
use BRANCH=YES the caller must be in supervisor state, have a protection 
key of zero, and set register 13 to point to a standard 72-byte save area. 
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All SMF records are given to user exits before they are written to the SMF 
data set. If you specify BRANCH=NO (or use the SMFWTM macro), user 
exit IEFU83 is invoked. If you specify BRANCH=YES, user exit IEFU84 
is invoked. 





Notes: If you are currently using the SMFWTM macro to write SMF records 
and change to the SMFEWTM macro, BRANCH=YES, then the SMF 
records are given to user exit IEFU84 (rather than user exit IEFU83). 


SUBS YS=name 

SSUBSYS=(reg) 
specifies the one to four character subsystem name or register (2)-(12) that con- 
tains the address of the four byte subsystem name. The subsystem name must 
be left-justified and padded with blanks. If a register is used, the register must 
be enclosed in parentheses. 


If SUBSYS is not specified, the subsystem name for the current address space 
is used. For example, TSO for TSO users, STC for started tasks, and the name 
of the job entry subsystem (JES2 or JES3) for batch jobs. 


The subsystem name is compared with the list of subsystems specified in 
SMFPRMxx. If the subsystem is listed in SMFPRMxx, the options for that sub- 
system are used to determine if the record is written. Otherwise, the options 
specified for the entire system by means of the SYS option are used. 


;WRKAREA=addr 
;WRKAREA=(reg) wa’ 
specifies the address or a register (2)—(12) that points to a five-word work area 
that you must supply for SMF to use. If a register is specified, the register must 
be enclosed in parentheses. WRKAREA must be specified if SUBSYS is 
specified. 


Record types 0 through 127 are SMF-formatted records. For all SMF-formatted 
records you must supply the RDW: 


e The RDW (offsets 1 and 2 in Figure 6-1 and 6-2) 


e The record type field in the standard SMF record header (offset 5 in Figure 6-1 
and 6-2) 


The SMFEWTM macro supplies the remaining header information. 


Record types 128 through 255 are available for user-written records. When 
using the SMFEWTM macro instruction to write user records, you must provide the 
standard SMF record header, which includes a four-byte record descriptor word 
(RDW) for each record. You must also fill in the date, time, and system identifier 
in the record header. While the system identifier can be any four character identifier, 
specifying the SMCASID is consistent with the system records SMF produces. 
(For a description of the standard SMF record header, see the chapter “SMF 
Records’’ in this book. For a description of the RDW, see Data Management 
Services.) 
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The SMFEWTM macro instruction returns a code in register 15 that indicates the 
record’s status, as follows: 


indicates the record was written without error. 


e 8 indicates the record was not written because the length specified in the 
RDW was less than 18 bytes. 


indicates the record was not written because SMF is not active. 


e °®6 
we = 
oOo an 


indicates the record was not written because the user-written IEFU83 or 
IEFU84 exit routine suppressed the record. 


@ 
ho 
a 


indicates that the record was not written because the data was lost. 


@ 
eS) 
On 


indicates that the record was not written because the record type specified 
is not currently being recorded. 


& 


indicates that the record was not written because a buffer shortage caused 
the data to be lost. 


iS 


indicates that the record was not written because SVC 83 could not 
establish recovery. 


Using the SMFRTEST Macro to Test Record Recording 


The SMFRTEST macro instruction allows a user to determine if a particular type of 
record is being recorded. This macro should be issued before collecting data for a 
record to avoid the overhead of data collection if the record is not written. The 
syntax is as follows: 





[label] SMFRTEST RECTYPE= 2record suBsYs= 472m@ 
(reg) (reg) 





The parameters are: 


RECT YPE=record 

RECTYPE=(reg) 
specifies the SMF record type to be checked, where record can be any one to 
three decimal digits (0-255). If reg is specified, the register (2)}-(12) contains 
the record type. The record type must be right-justified within the register. 


»UBSYS=name 

SUBS YS=(reg) 
specifies the one to four character subsystem name or register (2)}-(12) that 
contains the address of the four byte subsystem name. The subsystem name 
must be left-justified and padded with blanks. If a register is used, the register 
must be enclosed in parentheses. 


If SUBSYS is not specified, the subsystem name for the current address space 


is used. For example, TSO for TSO users, STC for started tasks, and the name 
of the job entry subsystem (JES2 or JES3) for batch jobs. 
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Using the SMFRTEST Macro to Test Record Recording (continued) ) 


The subsystem name is compared with the list of subsystems specified in 
SMFPRMxx. If the subsystem is listed in SMFPRMxx, the options for that sub- 
system are used to determine if the record type is selected. Otherwise, the 
options specified for the entire system through the SYS option are used. 


When the macro returns control, register 15 contains one of the following return 


codes: 
Code Meaning 
00 The record type is being recorded. 
16 SMF is not active. 
36 Information is not being collected for the specified record type. 


Note: Registers 14 and 15 are used by the macro and are not reset. On entry to 
the macro, register 13 must point to a 72-byte save area. 


Using the SMFEXIT Macro to Branch to the SMF Exits 


The SMFEXIT macro instruction allows the user to branch directly to any user- 
written SMF exit that resides in the SYS1.LPALIB. The SMF exit name must have 
been defined to SMF with the EXIT parameter before the macro instruction is 
issued. 





The syntax is as follows: 


[label] SMFEXIT exitname | sussys- ak [.WORKREG=(reg)] 


The parameters are: 


exitname 
specifies the load module name of the exit. 


SUBSYS=(reg) 

SUBSYS=name 
specifies the one to four character subsystem name or register (2)-{12) that 
contains the address of the four-byte subsystem name. The subsystem name 
must be left-justified and padded with blanks. If a register is used, the register 
must be enclosed in parentheses. 


If SUBSYS is not specified, the subsystem name for the current address space 
is used. For example, TSO for TSO users, STC for started tasks, and the name 
of the job entry subsystem (JES2 or JES3) for batch jobs. 


The subsystem name is compared with the list of subsystems specified in 
SMFPRMxx. If the subsystem is listed in SMFPRMxx, the options for that sub- 
system are used to determine if the exit is to be invoked. Otherwise, the options . 
specified for the entire system through the SYS option are used. 2 
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Using the SMFEXIT Macro to Branch to the SMF Exits (continued) 


,WORKREG=(teg) 
specifies a register that is intended for exits that run in 31-bit addressing mode. 
SMF uses this register to save and restore the caller’s addressing mode and 
return address. If you do not specify this parameter, the default is register 2. 


On entry to the macro, register 13 must point to a 72-byte save area. Parameters 
can be passed to the exit in register 0 or 1; the parameters must be placed in the 
registers before the macro is invoked. 


When control returns to the issuer, a return code of zero in register 15 indicates 
that the exit was not invoked either because SMF is not active, or because the exit 
is not active for the requesting subsystem. When the exit is invoked, the user-exit 
routine can place a return code in register 15. For more information see the 
section, “User-Written Exit Routines”’. 


Using the SMFINTVL Macro to Determine Interval Time 


The SMFINTVL macro instruction allows the user to determine the current 
INTERVAL value specified for a subsystem. A user subsystem could use this value 
to set up interval recording for a subsystem and MVS supervisor services to set up 
the timer value. For example, MVS uses this macro to determine how often to 
write interval type 30 records to SMF. 


The format is: 





[label] SMFEINTVL (interval) | sussys- a \ 
name 


The parameters are: 


interval 
specifies a register (2)-(12). When the macro returns control, this register con- 
tains the address of an eight-byte area that contains the interval value. The 
interval value is an unsigned 64-bit fixed-point number, where bit 51 is 
equivalent to 1 microsecond. 


»SUBSYS=name 

» UBSYS=(reg) 
specifies the one to four character subsystem name or register (2)-(12) that 
contains the address of the four-byte subsystem name. The subsystem name 
must be left-justified and padded with blanks. If a register is used, the register 
must be enclosed in parentheses. 


If SUBSYS is not specified, the subsystem name for the current address space 
is used. For example, TSO for TSO users, STC for started tasks, and the name 
of the job entry subsystem (JES2 or JES3) for batch jobs. 


The subsystem name is compared with the list of subsystems specified in 
SMFPRMxx. If the subsystem is listed in SMFPRMxx, the options for that 
subsystem are used to determine the length of the interval. Otherwise, the 
options specified for the entire system through the SYS option are used. 
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Using the SMFINTVL Macro to Determine Interval Time (continued) 


When the macro returns control, register 15 contains one of the following return 
codes: 


Code Meaning 


00 (interval) contains the address of the interval value. 

04 There is no interval time defined. The contents of (interval) are 
unpredictable. 

16 SMF is not active. The contents of (interval) are unpredictable. 


Using the SMFDETAL Macro to Test Detail Recording 


The SMFDETAL macro instruction is used to determine if detail recording is active 
for the current subsystem. A user subsystem could use this macro to determine 
what level of data to collect. For example, TSO uses SMFDETAL to determine if 
type 32 detail data or type 32 summary data is to be collected. 


The syntax is as follows: 





[label] SMFDETAL |(SuBsys= 27@™*s) 
(reg) 





The parameters are explained below: 


SUBSYS=name 

SUBSYS=(reg) 
specifies the one to four character subsystem name or register (2)-(12) that 
contains the address of the four byte subsystem name. The subsystem name 
must be left-justified and padded with blanks. Ifa register is used, the register 
must be enclosed in parentheses. 


If SUBSYS is not specified, the subsystem name for the current address space 
is used. For example, TSO for TSO users, STC for started tasks, and the name 
of the primary job entry subsystem (JES2 or JES3) for batch jobs. 


The subsystem name is compared with the list of subsystems specified in 
SMFPRMxx. If the subsystem is listed in SMFPRMxx, the options for that 
subsystem are used to determine if detail level data is requested. Otherwise, the 
options specified for the entire system through the SYS option are used. 


When the macro returns control, register 15 contains one of the following return 
codes: 


Code Meaning 


00 Detail recording is in effect. 
04 Detail recording for the subsystem is not in effect. 
16 SMF is not active. 
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Using the SMFSUBP Macro to Determine Subsystem Parameters 


An installation specifies a parameter string for a specific subsystem on the 
SUBPARM parameter in the SMF parmlib member. A user-defined subsystem 
issues the SMFSUBP macro instruction during subsystem initialization or after 
the subsystem interface call generated by a SET or SETSMF operator command. 


The syntax is as follows: 


name 


(label) SMFSUBP addr | sunsys- ‘ (reg) \ | 


The parameters are: 
addr 


specifies a register (2) — (12). When the macro return control, this register 
contains the address of the 60-byte information string followed by a four- 
byte field that contains: 


@ the length of the field in the first two bytes 
@ The source flags in the third byte. They are as follows: 


Bit Meaning when Set 
0 SMF is active 
l Reserved 
2 Information string was issued by parmlib member 
3 Information string was issued by operator reply 
4 Information string was issued by default 
5 Information string was changed due to conflicts or 
errors 
6 Information string was changed by IPL, SET, or SETSMF 
7 Reserved 


@ The console identifier in the remaining byte 


SUBS YS=(eg) 

UBS YS=name 
specifies the one to four character subsystem name or register (2)}-(12) that 
contains the address of the subsystem name. If a register is used, the register 
must be enclosed in parentheses. If SUBSYS= is not specified, the address of 
the SUBPARM value for the subsystem name of the current address space is 
returned. 


When the macro instruction returns control, register 15 contains one of the 
following return codes: 


Code Meaning 
0 Successful completion of the macro 
A No SUBPARM parameters are entered for the specified 
subsystem. 
16 SMF is not active. 
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Using the SMFCHSUB Macro to Change Subsystem Parameters 





A user-defined subsystem issues the SMFCHSUB macro instruction to change the 
information string specified in the current SUBPARM parameter. A user-defined 
subsystem issues this macro instruction when the subsystem determines that an error, 
such as a spelling error, exists in the information string. Issuing the macro instruction 
to correct the error causes the SMF options to be displayed correctly on the opera- 
tors console. 


The syntax is as follows: 





(label) SMFCHSUB SUBSYS= Su SUBPAR{ bate 


The parameters are: 


SUBSYS=name 

SYBSYS=(reg) 
specifies the one to four character subsystem name or register (2) — (12) that 
contains the address of the subsystem name. If a register is used, the register 
must be enclosed in parentheses. If SUBSYS= is not specified, the SUBPARM 
value (if one exists) for the subsystem of the current address space is changed. 


SUBPA RM=(eg) 


SUBPARM=addr 
specifies the address of a 60-byte area or a register (2) — (12) that contains the 
address of the 60 bytes that is to replace the current SUBPARM value for the 
specified subsystem. 
When the macro returns control, register 15 contains one of the following return 
codes. 
Code Meaning 
0 Successful completion of the macro instruction. 
4 No SUBPARM value found; thus, the value was not 
changed. 
8 A SETSMF or a SET command is currently being pro- 


cessed. SUBPARM is not changed for this request. 
The subsystem can reissue the macro instruction. 

12 A DISPLAY command for SMF is currently being pro- 
cessed. SUBPARM is not changed for this request. The 
subsystem can reissue the macro instruction. 

16 SMF is not active. 
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Chapter 5: User-Written Report Programs 


The SMF dump program (IFASMFDP) can be used to create data sets containing 
certain record types. In addition, the dump program produces a summary activity 
report. In some cases, an installation may wish to produce their own report. 
Producing a report usually requires at least two operations: sorting the SMF 
records and writing them in an appropriate format. 


For those installations choosing to read the SMF data sets directly rather than 
using the dump program, note that the SMF data sets are preformatted with dummy 
records. A dummy record is shorter than any valid SMF record and is easily 
identified because it contains the characters ‘SMFEOFMARK’. The SMF dump 
program terminates processing when it encounters a dummy record, thereby 
improving data set processing performance. 


Sorting SMF Records 


Any sort/merge program can be used to sort SMF records; this section describes two 
sample sort/merge exit routines that you may use with the IBM OS/VS Sort/Merge 
Program Product (Program No. 5740-SM1). (For a detailed description of this 
particular sort/merge program, see OS/VS Sort/Merge Programmer’s Guide. ) 


Sample Sort/Merge Exit Routines 


The IBM OS/VS Sort/Merge Program Product can, during various phases of 
execution, pass control to routines designed and written to perform specific 
functions. SYS1.ASAMPLIB has two sample routines that receive control from 
exits E15 and E35 of this sort/merge program. The sample E15 exit routine, called 
SMFE15, extracts all SMF records without a job log identification (job name and 
time and date that the reader recognized the JOB card) from the SMF dump data 
set. SMFEI5 retains the dump header and dump trailer records (types 2 and 3) in 
the temporary data set HDRDATA. It retains all other system-oriented records 
(records without a job log identification) in the temporary data set SORDATA. 


The sample E35 exit routine, called SMFE35, places all the records extracted by 
the SMFE15 routine in the sort output data set. These records are inserted in the 
data set as follows: dump header records, dump trailer records, all other system- 
oriented records, and the sorted job-oriented records. 


Note: If tape work devices are used, the minimum block length the IBM 
Sort/Merge Program Product can sort is 18 bytes. Otherwise, the minimum is one 
byte. The sample routines SMFE15 and SMFE35 use SMF record types 0 through 
13 for input; the minimum length of these SMF records is 18 bytes. 
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Figure 5-1 shows sample JCL for obtaining a listing of the SMFE15 and SMFE35 J 
exit routines from SYS1.ASAMPLIB. Figure 26 also shows sample JCL for obtaining 

a listing of the SYS1.ASAMPLIB member named SMFSORT. SMFSORT contains 

sample JCL for executing the IBM OS/VS Sort/Merge Program Product: 


//PRINT JOB 123456,SMITH 
// EXEC PGM=I|IEBPTPCH 
/ISYSPRINT DD SYSOUT=A 
[ISYSUT1 DD DOSNAME=SYS1.ASAMPLIB,DISP=(OLO,KEEP), 
If UNIT=xxxx, VOLUME=*SER®xxxxxx2 
HISYSUT2 DD SYSOUT#=A 
IISYSIN DD ° 
PRINT TYPORG=P0 MAXNAME="4,MAXFLDS=4 


MEMBER NAME#SMFSORT 
RECORD FIELD=(80) 
MEMBER NAME#=SMFE15 
RECORD FIELD*~(80) 
MEMBER NAME=SMFE35 
RECORD FIELD=(80) 

/* 





1The volume and unit parameters depend on your instailation’s request. 


Figure 5-1. Sample JCL for Obtaining a Listing of Sample Sort Exit Routines 


To include the sample exit routines in your sort application, you must assemble 
and link-edit them before executing the sort/merge program. Figure 5-2 shows 
sample JCL for this procedure, including one possible sort application. In this 
example, SMF records are to be sorted first on the job log identification (major 
control field), and then on the time and date portions of the time stamp (minor 
control fields). Displacements of these fields (as shown in the record formats in 
the next chapter) are 14, 6, and 2. Note, however, that you must add an additional 
four bytes for the RDW and one byte for the sort procedures (initial count of 1) 
to these displacements. Hence, displacements 19, 11, and 7 are shown in the 
SORT FIELDS= statement in Figure 5-2. 
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//SMFSORT 
/ISTEP1 
//ASM.SYSIN 


(E15 Source Deck) 
/* 
//LKED.SYSLMOD 
// 


Hl 
//LKED.SYSIN 


/* 
/ISTEP2 
//ASM.SYSIiN 


(E35 Source Deck) 
/* 
//LKED.SYSLMOD 


MH 
//LKED.SYSIN 


/* 

//SORTSTEP 

LIISYSOUT 

//SORTLIB 

//EXITLIB 

Il 

HISORTIN 

iI 

//SORTWKO1 

//SORTWKO2 

//SORTWKO3 

//SORTOUT 

iI 

/ISORDATA 

iI 

//HDRDATA 

iI 

/ISYSIN 
SORT 
MODS 
END 

/* 


JOB 
EXEC 
DD 


DD 


DD 


NAME 


EXEC 
DD 


DD 


DD 
NAME 


EXEC 
DD 
DD 
DD 


DD 


MSGLEVEL=1 
ASMFCL} 


DSNAME=SMF1.EXITS,UN!IT=2314,4 
DISP=(NEW,KEEP) SPACE=(TRK,(10,5,1)), 
VOL=SER=335000 


E15(R)3 


ASMFCL2 


DSNAME=SMF1.EXITS,DISP=(OLD,KEEP),* 
UNIT=3350,VOL=SER=335000 


E35(R)° 


PGM=SORT,REGION=100K* 

SYSOUT=A 
DSNAME=SYS1.SORTLIB,DISP=SHR 
DSNAME=SMF1.EXITS,DISP=(OLD,KEEP),° 
UNIT=3350,VOL=SER=335000 6 
UNIT=2400, VOL=SER=SYSMAN,DISP=OLD, 


LABEL=(,SL),DCB=(RECFM =VBS,LRECL=600,BLKSIZE=200) 7 


DD 
DD 
DD 
DD 


UNIT=3350,SPACE=(TRK,(50), ,CONTIG)® 
UNIT=3350,SPACE=(TRK,(50), ,CONTIG)® 
UNIT=3350,SPACE=(TRK, (50), ,CONTIG)® 
UNIT=2400,DSNAME=SMF1.SORTOUT,LABEL=(,SL),9 


DISP=(,KEEP),.DCB=(RECFM=VBS,LRECL=600,BLKSIZE=200) 7 


DD 


DD 


DD 


UNIT=SYSDA,SPACE=(CYL,(1,1)),2 
DCB=(RECFM=VBS,LRECL=600,BLKSIZE=200) ” 
UNIT=SYSDA,SPACE=(TRK,(5,5)},2° 
DCB=(RECFM=VBS,LRECL=600,BLKS!IZE=200) 7 


FIELDS=(19,16,A,11,4,A,7,4,A) FORMAT=BI,SIZE=E4000?! 
E15=(£15,700,EXITLIB,N),£35=(E35,1500,EXITLIB,N)22 


1EXEC statement for cataloged procedure ASMFCL (assemble and link-edit). (For a description 
of the ASMFCL procedure, see Assembler H Version 2: Application Programming Guide.) 
2The sample sort exit routines will be link-edited into data set SMF1.EXITS. 


3Link-edit control statements specifying that E15 and E35 will be the load module names of the 


exit routines. 


4EXEC statement for the sort/merge program. 
*Data set SMF1.EXITS is specified as the library in which sort exit routines can be found. 


SInput to the sort program is the SMF dump data set, contained on a tape having a volume 
serial number of SYSMAN. 


7The LRECL value can be larger than the BLKSIZE value because records might be segmented. 
The LRECL value must be as larga as the longest SMF record being created pilus four bytes for 
the ROW. Modify these parameters according to the longest record to be collected. 

8Three sort work units are defined as being direct access devices. 

9T he sort Output data set is to be written on tape. 


10Two data sets required by the sample sort exit routines are defined on direct access devices. 


11The sort/merge control statements define the sort control fields and exit routines to be used 
in this sort application. 


Figure 5-2. Sample JCL for Executing a Sort Procedure 
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Designing a Report Program 


The basic operations of a report program are formatting and printing data from 
SMF records. The input to a report program is normally the sorted SMF data set. 


SYS1.ASAMPLIB has a sample PL/1 source report program, called SMFFRMT. 
which formats record types 23 and 90. Contained within the program are declares 
for record types 23, 30,32, and 90. Figure 5-3 illustrates a sample SMF activity 
report and an operator tracking report produced by SMFFRMT. 


SMF ACTIVITY REPORT 
TIME 5:01:47 PM DATE 05/03/85 


SYSTEM TIME RECORD DATA REC REC PRODUCT REPORTING RELEASE BUFFERS RECORDS BUFFERS RECORDS MAX FULL # USERS 
ID WRITTEN WRITTEN VER NAME INTERVAL NUMBER WRITTEN WRITTEN PER MIN PER SEC BUFFERS SUSPENDED 


18 05 
~06 -01 
.00 - 00 
-00 00 
40 -37 
-00 00 
-00 -60 
- 00 


00 
00 
00 
00 
00 
00 
00 
00 


168A 10:30:37.86 03/20/79 01 SMF 01:00:00 0398 11 208 
168A 11:51:03.51 03/20/79 01 SMF 01:00:00 038 ou 67 


168A 8 12:51:03.82 03/20/79 01 SMF 01:00:00 0398 00 09 
168B 13:51:03.92 03/20/79 01 SMF 01:00:00 038 00 13 
168A = 12:37:04.41 03/20/79 01 SMF 00:05:00 038 07 111 
168A = 12:39325.11 01/12/12 01 SMF 01:00:00 038 42 
MINE 21:06:39.15 03/20/79 01 SMF 00:01:00 038 01 36 
MINE 21:07:39.17 03/20/79 01 SMF 00:01:00 0398 00 Ou 


OO }S500 0 
Oe GewOO0—0 


So 


-07 


wo 


TOTAL / AVERAGE / MAXIMUM 23 460 00 





OPERATOR TRACKING REPORT PAGE 27 
TIME 5:01:47 PM DATE 05/03/85 
SYSTEM TIME RECORD DATE REC REC PRODUCT 
ID WRITTEN WRITTEN VER NAME 


V68A 12212:43.12 03/20/79 01 SMF 


“@e@ SMF OPTIONS AT SET 


MAXDORM STATUS JOB WAIT TIME SYSTEM MIN MAX REL 


MM:SS HH:MM:SS HH > MM ID BUFS BUFS NUM IPL TIME IPL DATE 
30:00 01:00:00 00:10 168A 4 9 039 11:18:49.88 03/20/79 
PROMPT (ALL) REC (PERM) LISTDSN 


ACTIVE SMP RECORDING DATA SETS 


SYS 1.MANC SYS1.MAND 


RECORDING OPTIONS BY SUBSYSTEM 
SYS NAME DETAIL RECORDING INTERVAL 
syYs NOT IN EFFECT * NONE * 
RECORDS COLLECTED FOR THIS SUBSYSTEM (BITS REPRESENT COLLECTABLE RECORDS) 
FFFFFFFFFFFFFFFFFFFFPPFFFFFFFFFPPFFPFFFPFFFPFFFFFFFEFFFFFFFFFFFFF 
ACTIVE SMF EXITS FOR THIS SUBSYSTEM 
IEFUTL IEFUSI IEFUSY LEFUJI LEPACTRT IEFU29 IEFUS4 IEFUS3 
SYS NAME DETAIL RECORDING INTERVAL 
TSO IN EFFECT * NONE * 
RECORDS COLLECTED FOR THIS SUBSYSTEM (BITS REPRESENT COLLECTABLE RECORDS) 
FFFFFFFFFFPFFFFFFFFFFFFFFFFFFFFFEFFFFFFFFFFFFFFFFFEFFFFFFFFFFFFFFF 
ACTIVE SMF EXITS FOR THIS SUBSYSTEM 


IEFU83 IEFUS4 IEFPU29 IEFACTRT IEFUJI IEPUJV IEFUSI ITEFUTL 


Figure 5-3. Sample Output from SMFFRMT 


5-4 System Management Facilities (SMF) 


Before using the SMFFRMT program, you must compile the program using the 
PL/I compiler. Figure 5-4 shows sample JCL for executing the SMFFRMT program 
after it is compiled and link-edited into SYS1 .LINKLIB. 


//FORMAT JOB MSGLEVEL=1 

//FRMT EXEC PGM=SMFFRMT 

HISYSPRINT DD SYSOUT=A 

//REPORT DD SYSOUT=A 

IISMFDATA DD DISP=(OLD,KEEP),LABEL=(,SL), VOL=SER#@xxxxxx, DSN=nnn, 
I UNIT=2400 


Figure 5-4. Sample JCL for Executing SMFFRMT 
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Chapter 6: SMF Records 


This chapter fully describes all of the SMF-formatted records. Note that the fields 
in these records marked “‘Reserved”’ are for use by SMF and are not available for 
your use. 


Standard SMF Record Header 


Each record written to the SMF data set by the SMF writer routine contains the 
standard SMF record header. Each user record written to the SMF data set by 
user-written routines should also include the standard record header. The length 
and field types for the record header vary with the kind of record written. Figure 
6-1 illustrates the header for records without subtypes; its length is 18 bytes. 
Figure 6-2 shows the header for records with subtypes; its length is 24 bytes. 


The header contains information about the record such as record type, record 
subtype if the record includes subtypes, record length, and the time and date the 
record was written to the data set. Record subtypes are used to group related data 
and control record types. For example, one record might contain three separate 
subtypes, each reporting different kinds of data; by using those subtypes you can 
eliminate the need for three separate record numbers. When designing your SMF 
record, you should make use of record subtypes efficiently. Many small subtypes 
within a record could create excessive I/O when written to the SMF data set, while a 
larger record with fewer subtypes can help avoid high I/O overhead. 


The header section must include the record descriptor word (RDW). The RDW isa 
4-byte field that must precede an SMF record when it is written to the SMF data 
set by the SMFWTM macro instruction. The first two bytes of the RDW must 
contain the length of the logical record (including the four bytes of the RDW). The 
second two bytes are used for variable blocked spanned records; that is, records 
that contain more than 32,760 bytes. This field (the second two bytes) is set to 
zero if the record is not spanned. For a discussion of the RDW, see Data 
Management Services. 
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gd 


(The ‘‘Name” field in all 2 binary internal Record length (maximum size of 32,760)! 
of the SMF records 

contains the symbolic 

addresses defined by the 

IF ASMFR macro 

— —— } 


binary SVC 83 System indicator 
Bit Meaning When Set 
internal 0 Subsystem identification follows system 

identification 
Reserved 
MVS/XA 
VS2 
VS1 


P| inary | | internal Record type (Hexadecimal values are 0-255) 


binary sve 11 Time since midnight, in hundredths of a second, 
record was presented to SMF? 
sve 83 
packed eve 11 Date record was presented to SMF, in the form 
OOYYDDDF, where F is the sign? 
svc 83 
EBCDIC | JUMRCPUID System identification {taken from SID 
or parameter) 
SMCASID 


' These two fields (total of four bytes) form the record descriptor word (RDW). The first two 
bytes must contain the logical record length including the RDW. The second two bytes are 
used for variable block spanned records. If the record is not spanned, set these two bytes to 
hexadecimal zeroes. These fields must be filled in before writing the record to the SMF data 
set. 





*In record types 2 and 3, these fields indicate the time and date that the record was moved to 
the dump data set. 


Notes: 


1. Because the record formats include the RDW, it is mot necessary to add four bytes to the 
offset listed in the record; however, depending on the access method used to read the record 
from the SMF data set, these fields might not be present in your SMF record. In this case, 
you might have to subtract four bytes from the offsets listed in your record. 


2. For MVS/XA, both the MVS/XA bit and the VS/2 bit are set. 
Figure 6-1. Standard SMF Record Header for Records without Subtypes 
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Corme [me ewmm rome [ee me 


(The “Name” field in all binary internal Record length (maximum size of 32,760)! 
of the SMF records 

contains the symbolic 

addresses defined by the 

IFASMFR macro 

instruction. ) 


binary System indicator 
Bit Meaning When Set 
internal 0 Subsystem identification follows system 

identification 

Reserved 

MVS/XA 

VS2 

VS1 


binary SVC 11 Time since midnight, in hundredths of a second, 
or record was presented to SMF“ 
SVC 83 
10) A 


packed SVC 11 Date record was Presented to SMF, in the form 
or OOY YDDDF, where F is the sign? 
SVC 83 


JUMRCPUID System identification (taken from SID 
or parameter } 
SMCASID 


18 EBCDIC internal Subsystem identification. This field is a four 
byte character value set by the SUBSYS=option 
specified in the SMF macros. 


1 These two fields (total of four bytes) form the record descriptor word (RDW). The first two 
bytes must contain the logical record length including the RDW. The second two bytes are 
used for variable block spanned records. If the record is not spanned, set these two bytes to 
hexadecimal zeroes. These fields must be filled in before writing the record to the SMF data 
set. 





In record types 2 and 3, these fields indicate the time and date that the record was moved to 
the dump data set. 


Notes: 


1. Because the record formats include the RDW, it is not necessary to add four bytes to the 
offset listed in the record; however, depending on the access method used to read the record 
from the SMF data set, these fields might not be present in your SMF record. In this case, 
you might have to subtract four bytes from the offsets listed in your record. 


2. For MVS/XA, both the MVS/XA bit and the VS/2 bit are set. 
Figure 6-2. Standard SMF Header for Records with Subtypes 
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Summary of SMF Records 





Figure 6-3 summarizes the SMF records according to the type of data they contain, 
such as VSAM or JES2 data, and the events (or status indicators) that cause SMF 
to generate the records. To write any SMF-formatted records (except record types 
2,3 and 7) to the SMF data set, you must specify the ACTIVE parameter. To 
write record type 17 for temporary data sets, you must specify REC(ALL). Figure 
6-2 also indicates the method of entry to the SMF SVC 83 routine. The method of 
entry determines which user exit routine, either IEFU83 or [IEFU84, receives 
control before control is returned to the caller of the SVC 83 routine. A branch 
entry, indicated by BR, results in the IEFU84 exit receiving control whereas an 
SVC call, indicated by SVC, results in the IEFU83 exit receiving control. 


Many current SMF records contain variable sections. The user of these records 
should be aware that the record pointers must be updated by the length of each 
variable section of the record when the record data is being manipulated. Failure 
to do the address calculation will result in writing over valid data in previously 
processed sections. Other SMF records such as record type 23, 30, 32, and 90, 
contain offsets that point directly from the record header to the data section. 


Note: Ina loosely-coupled multiprocessing environment (such as JES2 shared spool or 
JES3), it is possible for the job START/LOGON time to be greater than the STOP/ 
LOGOFF time because the installation does not synchronize the CPU clocks. The dif- 
ference occurs when the START/LOGON time is initialized on processor (A) and the 
job is then executed on processor (B). The STOP/LOGOFF time is recorded from 
processor (B). 





For a summary of all of the fields in the SMF records, see “Chapter 7: Field- 
to-Record Cross-Reference.” 
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Category Record Entry 
ee 1 
Devices online at IPL 


MODIFY TCAM command issued 
SET, HALT and SWITCH command 

information 

CPU, storage, or channe! path 

moved online or offline 


Machine Devices brought Online 


1 
Data Soe 
Devices recovered at allocation to | see 


Devices taken offline 














Day Data 










Space available on DASD volumes: 
at IPL, after HALT EOD or SWITCH 
SMF command, when demounted 


Tape volume demounted | 21 | SVC 


VSAM data space defined, extended, SVC 
or deleted 


Step processing 







Auxiliary 
Storage 
Data 


Job processing 


SYSOUT processing 
ic a 


Data set dynamically unallocated, 


concatenated or deconcatenated a oe 


Normal or abnormal termination | 30 | BR 
TSO normal or abnormal termination | 32 «|: BR 


Data Set opened for 
Non-VSAM closed or 
Data Set processed | Data set opened for 
Activity by EOV OUTPUT, UPDAT, SVC 
Data INOUT, or OUTIN 


"Data set renamed ——S~S~sYStw Ys 


Integrated Catalog Facility component SVC 
or cluster created, updated or deleted 
VSAM Integrated Catalog Facility entry SVC 


ooevity Component or cluster opened 
et 
[Component orclusterstanua | 64 | svc 


Integrated Catalog Facility entry SVC 
deleted 
Integrated Catalog Facility entry 


[entry renamed ———SSC~=~“‘~*~‘~stSC‘iSC*d;C(SW 


Tonly when written after an IPL by IEEMB823. All other records are written by means of an 
SVC call. 


zExcept when written for aSETDMN command by |EE8603D or for a HALT EOD command 
by |EE70110. These records are written by means of an SVC call. 


Figure 6-3, Summary of SMF Records (Part 1 of 3) 
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of Data Type Type 
TES On Wier ———~SOSC~tCia SSC 
[5652078 SYS conmand ones | 3 | sve 
$P JES2 command issued | 45 | Svc - 


SVC 








$S LNEn or $E LNEn command 
issued, or remote user signed on 


$P LNEn command issued or remote 
user signed off 


$E LNEn command issued, or 





Ei 
~~ 


SVC 





RJP line stopped or remote 
user signed off 


” 
< 
O 


Remote user attempted to sign 


JES2 remote user attempted to sign on oo SVC 

Data with invalid password 
TJES2 LOGON/Stert Line —*«|—s2~d|sSve 
Pses2imegrty SS*~*‘d(]C‘éaSC*;S«CSVCG 
T Network Signon —SS*~srSC<C_ OSC 
[Network integrity ——=—Ss«dt=SiB «|S 
TNeworkSinoff ——=sSC*d?S=Ci | SVC 
[Job procesied by JESSMDS | 28 | svc 
Psesastared——SSSCSC*~‘dSC‘SC*«d;CSV 

Data user signed on 






on with invalid password svc 
JES3 completes a network 
. 57 SVC 
transmission 
Network Prablem Determination 37 SVC 
Network Application reporting 
Data Network Performance Monitor 
Network Logical Data Manager 


Data Transmission 
[Dumpraier SSSSSC«d SS «CNA 





VC 
SVC 















Record 


Management! SMF records lost | 7 | BR 
Data Record descriptor word (RDW) 






Block descriptor word (BDW) N/N 
RACE Processing Record ) 80 SVC 
Initialization Record | BL SVC 
ACF/VTAM 
Tuning Data | ACF/VTAM tuning statistics SVC 


Figure 6-3. Summary of SMF Records (Part 2 of 3) 
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Category Event or Status Record 
of Data 


sv 
sve 
svc 

z 

i 

r 

vi 

100 

; [101 






Page/Swap Data Set Activity 
Record 


DATABASE performance | 102 
CICS/VS statistics | 110 


Figure 6-3. Summary of SMF Records (Part 3 of 3) 


Data Base 
information 
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Record Type 0 (00) — IPL 


Record type 0 is written by IEEMB823 after every IPL of the system. It includes 
the virtual and real storage sizes and some of the SMF options in effect. Its length is 
35 bytes: 


The format is: 


ny Ten ee ee 
Teo | swrouen [2 | inary [inerrat [Resor ngeh 
a [2 | swroses [2 [inary [vernal 


SMFOFLG binary | SVC ——__ System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
° VS2 
VS1 


| 8 {| 5 | smronty | 1 | binary [internal | Record type 
binary | SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 
SMFODTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 
| EBCDIC|/SMCASID si System identification (taken from SID parameter) 


4 _| Esco Limit, in minutes, of continuous weit time for the job 
(taken from JWT parameter) 


| 22 | 16 | SMFOBUF | 4 | binary | SMCANMBF x 4096 | Number of bytes in SMF buffer 
| 26 | 1A | smFovst | 4 | binary | (CVTMZ00+1)/1024 | Number of 1K bytes in virtual storage 
data sets (REC(ALL)) 


SMFOOPT binary | SMCAOPT SMF options 
7 Reserved 


Bit Meaning When Set 
31 | 4e | SMFORST | 4 | binary | CVTRLSTG Number of 1K bytes in real storage 


0 Reserved 
Notes: 


1 Reserved 
2 Reserved 
3 
1. This bit is set on when one of the following record types is 
selected: 14,15, 17, 18, 62, 63, 64, 67, or 68. 





























Data set accounting. Record types (see Note 1) 


selected 

4 Volume accounting. Record types 10 or 
selected 

5 Reserved 


6 Type 17 records will be written for temporary 
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Record Type 2 (02) — Dump Header 


Record type 2 is written directly to the dump data set by IFASMFDP, the SMF 
dump program. This record consists of only the standard SMF record header. It 
indicates the beginning of a dump of the SMF data set from a direct access device 
usually to a tape. Its length is 18 bytes. 


The format is: 


<1 eee a 
5 MVS/XA 
SMF2DTE packed | SVC 11 (Set by Date record was moved to the dump data set, in the form 
a —— OOY YODDF where F is the sign 


| 2 | binary | internal Segment descriptor 
; VS2 
SMCASID —_| System identification (taken from SID perameter) | identification | System identification (taken from SID perameter) from SID perameter) 



















ae are System indicator 
VS1 


Bit Meaning When Set 
| 8 | 6 | smrzaty | 1 [binary [internat | Recordtype 


0-4 Reserved 
SMF2TME binary | SVC 11 (Set by Time, in hundredths of a second, record was moved to the 
IF ASMFDP) dump data set 
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Record Type 3 (03) — Dump Trailer 


Record type 3 is written directly to the dump data set by IFASMFDP, the SMF 
dump program. This record consists of only the standard SMF record header. It 
marks the end of a dump of the SMF data set from a direct access device usually 
toa tape. Its length is 18 bytes. 


The format is: 


Sp eS eg Deserintion 
5 MVS/XA 
SMF3DTE packed | SVC 11 (Set by Date record was moved to the dump data set, in the form 
IF ASMFDP) OOY YDDDF where F is the sign 


vS2 
| 14 | E SMF3SID | 4 | eBcpic|smMcasiD si System identification (taken from SID parameter) 



















SMF3FLG ene SVC ern) System indicator 
VS1 


Bit Meaning When Set 
0-4 Reserved 
Te [= [awranry [+ | einay [internat | Recor ype 
SMF3TME binary | SVC 11 (Set by Time, in hundredths of a second, record was moved to the 
|FASMFDP) dump data set 
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Record Type 4 (04) — Step Termination 





Record type 4 is constructed by IEFTB722 and written by IEFTB72] at the 
normal or abnormal termination of a job step for a background job, or when a job 
step is flushed during or after job initiation. It is not written for a job step that 
follows a CANCEL operator command. Its length is 202 bytes plus (1) eight bytes 
for each device entry and (2) the length of the step accounting fields. 


This record identifies the job step by the job log identification, step name, 
number of the step within the job, user identification, program name and perform- 
ance group number. If accounting numbers (which can be alphameric) were 
specified in the EXEC statement, they are included. 


This record also contains operating information such as the job step start and 
end times, step CPU time, step service, step termination status, number of records 
in DD DATA and DD” data sets for the step, device allocation start time, problem 
program start time, and storage protect key. It contains the number of page-ins, 
page-outs, swap-ins, and swap-outs for both VIO and non-VIO data sets. 


Record type 4 has an entry for each non-spooled data set that was defined by a 
DD statement. Each entry lists the device class, unit type, channel address, unit 
address, and EXCP count for the data set. 


Notes: 

1. Data sets are usually recorded in the order of the step DD statements; they are 
not identified by name. (A user-written IEFUJV exit routine can record this 
order as each statement is validated.) Dynamic allocation or deallocation can 
affect the order. 





2. For data sets that are dynamically unallocated, the data set entry information is 
in record type 40 — not in record type 4. 


3. For more information on EXCP count and CPU time, see Chapters 8 and 9, 
respectively. 
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The format is: 


orm [Nene [tna [rome | ere [Ce 
0 [ 0 SWFaLEN [2 [binary [avernel [Record ongth 
2 [2 [srasec [2 [binary [internat | Sopment descriptor 


SMF4FLG binary | SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
° VS2 
VS1 


ss | swrenry [1 | inary Record type 
pe 8 SMF4TME binary | SVC 83 Time, in hundredths of a second, record is passed to the 
SMF writer. This is the time the step terminated. 

SMF4DTE packed | SVC 83 Date in the form OOY YDDDF, where F is the sign, record is 
passed to the SMF writer. This is the date the step 
terminated. 

| SMF4sID | 4 |EBCDIC) JMRCPUID System —_—v (taken from SID parameter) 
Fi pe [ewan oJeseote moe 


1A | SMF4RST binary | JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job+ 
packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOYY DDDF where F is the sign? 
ce SMF4UIF |S |Fscoic JMRUSEID User identification (taken from common exit parameter 
area) 


| 42 | 2A | SMF4STN | 1 | binary | LCTSNUMB Step number (first step=1, etc.) 


SMF4SIT binary | JCTJMRSS (Set by| Time, in hundredths of a second, initiator selected this step 
i\EFSMFIE) 
a SMF4STID packed | |CTSSD (Set by | Date initiator selected this step, in the form OOYYDDDF 
IEFSMFIE) where F is the sign 


binary | SCTSMF Number of card-image records in DD DATA and DD® data 
sets read by the reader for the step 


37 binary | TCBCMPC Step completion code: 

X'Occc’ indicates system ABEND in the job step where ccc 

is the system ABEND code. (See System Codes.) 

X'8ccc’ indicates user ABEND In the job step where ccc 

is the user ABEND code. 

X‘nnnn’ indicates normal completion where nnnn is the 

contents of the two low-order bytes in register 15 at 

termination. 

X‘0000’ indicates either 

(1) the job step was flushed (not executed) because of an 
error during allocation or in a preceding job step, or 

(2) normal job completion with a return code of 0. 

Use this field in conjunction with the step termination 

indicator field (offset 87). 


1The job name and the time and date that the reader recognized the JOB card for this job constitute the job (Continued) 
log identification. 
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fortes [Name [Lsnath [Format [Sous Dearipon 
57 | 39 | SMF4PRTY binary SCTSDPTY Address space dispatching priority (taken from DPRT Y= 
parameter on EXEC card or the APG value in CVTAPG)2 
58 | 3A | SMF4PGMN EBCDIC |SCTPGMNM 
card). If a backward reference was used (SCTSTYPE equals 
X‘80'), then this field containd *.DD. 
66 | 42 | SMF4STMN p38 | EBCDIC |SCTSNAME Step name (taken from name on EXEC card) 


74 | 4A | SMF4RSV5 2 binary Reserved. Note that SMF4RSHO, formerly a two-byte 
field at this offset, has been increased to four bytes and 
moved to offset 82. 

76 | 4C | SMF4SYST binary |TCTHWM/1024 Largest amount of storage used from top of private area, 
In 1K units. This storage area includes the LSQA and SWA 
(subpools 229, 230, 236, 237 and 253-255). lf 
ADDRSPCSREAL is specified, this field equals the amount 
of storage used that was not from the contiguous real 
storage reserved for the program. See offsets 82 and 102.3 

78 SMF4HOST 2 binary FT CTLWM/1024 Largest amount of storage used from bottom of private 
area, in 1K units. This storage area includes subpools 
0-127, 251 and 252, |f ADDRSPC=REAL is specified, 
this field equals the amount of contiguous real storage 
that was used. See offsets 82 and 102.3 

reo [so |swranvt | 2 [pinay | +d ‘Reserved 


| Reserved 

52 | SMF4RSHO binary TCTRSZ*2 Region size established, in 1K units taken from the 

REGION= parameter in the JCL, and rounded up to a 4K 

boundary. If ADDRSPC=REAL is specified, this field equals 

the amount of contiguous real storage reserved for the pro- 

gram. If the region requested was greater than 16 megabytes, 

the region established resides above 16 megabytes, and this 

field will contain a minimum value of 32 megabytes. 


56 | SMF4SPK binary TCBPKFE Storage protect key, in the form xxxx0Q000 where xxx is 
the key 
equals 0722, IEFUSO caused ABEND. 


87 | 57 | SMF4STI 1 binary Step termination indicator 
TCTHWM If 0, normal completion. If 1, step was flushed. 


rae [ se] swranva | 2 [ome | id Cee 


90] 88 SMF4AST | 4 [pinay TCTAST (Set by Device allocation start time, in hundredths of a second 
IEFBB401) 


(Continued) 










Program name (taken from PGM= parameter on EXEC 




















Meaning When Set 
0-1 Reserved 

2 Canceled by exit [EFUJI4 

3 Canceled by exit |EFUSI4 

4 Canceled by exit IEFACTRT4 

5 Step is to be restarted 

6 If 0, normal completion. If 1, ABEND. If step 
completion code (offset 55) equals 0322 or 0522, 
IEFUTL caused ABEND. If step completion code 














JCTIMRCL 
JCTIMRCL 
JCTJIMRCL 
JCTSTEPR 
TCBFA 











at the dispatching priority falls within the APG range, the actual execution dispatching priority 


will be assigned based on the Installation Performance Specification (IPS). If the dispatching 
priority is controlled via the IPS, it may periodically change based upon user characteristics. 

If the dispatching priority is not in the APG range, the value in the field (SMF4PRTY) will be the 
actual execution dispatching priority. For more information see /nitiaiization and Tuning. 


31 ¢ storage was not allcoated (job step was flushed), these fields equal zero. 


4 Job steps canceled by IEFUJI and IEFUSI will not be executed; therefore bit 7 will also be on, Job steps 
canceled by IEFACTRT will cause subsequent job steps to be canceled; record type 4 is not produced for 
subsequent job steps. 
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C 
















Sg 

This field includes the CPU time for various supervisory 

binary Record indicator 
Bit Meaning When Set 
0-5 Reserved 
6 EXCP count might be wrong.® 
7 lf 0, storage is virtual. 

If 1, storage is real. 
8-15 Reserved 
SMF4DEVC i UCBTBYT3 Device class 


binary | TCTPPST (Set by Problem program start time, in hundredths of a second 
[EFAB8820) 
routines that are dispatched via SRBs: locking routines, 
68 | SMF4RLCT binary | internal Offset from the beginning of the record (SMF4FLG) header 
to the relocate section 
SMF4UTYP UCBTBYT4 Unit type 


page resolution, swap control, cross-memory communica- 
106 SMF4LENN binary Length of device entry portion of record. Calculated as: 
(8 times the number of devices) + 2 
SM F4CUAD UBCHAN : Device number. 


62 | su F4SRBT binary | SCTSRBT ee CPU time under SRBs, in hundredths of a second. 
tlons (WAIT, POST, I/O POST), and TQE scheduling. 
For each device assigned to each non-spooled data set, there is an eight-byte entry with the following format: | 
SMF4EXCP i TCTDCTR EXCP count (see offset 102). 




















SMF4LNTH 
SMF4SETM 





Length of accounting section, excluding this field 


Step CPU time under TCBs, in hundrecths of a second. 
This field includes the CPU time for all tasks that are 
dispatched via TCBs below the level of RCT.° 


Number of accounting fields 















SMF4NAF 


Accounting fields. Each entry for an accounting field 
contains the length of the field (one byte, binary) followed 
by the field (EBCDIC). A zero indicatas an omitted field. 





binary | OUXBPIN Number of non-VIO, non-swap page-ins for this step. This 
field includes page-ins required through page faults, specific 
page requests, and page fixes. It does not include page 

reclaims, page-ins for VIO data sets, pages that are swapped 


in, and page-ins for the common area. 





3 (Continued) 
If storage was not allocated (job step was flushed), these fields equal zero. 


SCPU time is not expected to be constant between different runs of the same job step. For more information on 
CPU time, see Chapter 9. 


61f a GETMAIN for expanding the TCTIOT (the data area where EXCPs are maintained) fails, only the existing 
data sets are counted. If the functional recovery routine is entered, EXCP counting for the step is discontinued 
and no device entries are produced. If ADDRSPC=REAL is specified, the EXCP does not include PCls. For more 
information on EXCP count, see Chapter 8. 

7Entries for DD*, DD DATA, DD DUMMY and spooled data sets are zero, (A DD DUMMY entry occurs when a 
forward reference toa DD statement with that DD name, but no matching OD statement is found, or when DD 
DUMMY is specified.) Entries for virtual |/O data sets are zero for class and type, and X’7FFF’ for device number. 
When the high order bit is on in the device number field, a virtual device is indicated. 


8The displacement of this field depends upon the size of the accounting fields and the number of devices. Offset 
104 contains the displacement for this field. 
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[otets [Name [Lensti] Format | Source [SSC 


Relocate Section: (Continued) 
SMF4PGOT binary OU XBPOUT Number of non-VIQ, non-swap page-outs for this step. 

This field includes page-outs required through specific page 
requests as wei] as those pages stolen by the paging 
supervisor as a result of infrequent use. It does not include 
page-outs for VIO data sets, pages that are swapped out, 
and page-outs for the common area. 
found in storage during the swap-in procass (such as pages 
on a VIO window. It does not include VIO swap-ins or 


+8 binary | OUXBSWCT Number of address space swap sequences. (A swap sequence 
consists of an address space swap-Out and swap-in.) 
brought in via SRB’s started after completion of swap-in 
page-ins for the common area. 















+12 binary OUXBSPIN Number of pages swapped in. This field includes: LSQA, 
Stage 1 processing). 


fixed pages, and those pages that the real storage manager 
determined to be active when the address space was 
swapped in. it does not include page reclaims nor pages 

binary OUXBSPOT Number of pages swapped out. This field includes: LSQA, 

private area fixed pages, and private area non-fixed changed 
pages. 

+20 SMF4VP! binary OUXBVAMI Number of VIO page-ins for this step. This field includes 

page-ins resulting from page faults or specific page requests 

+24 SMF4VPO in OUXBVAMO 

















Number of VIO page-outs for this step. This field includes 
page-outs resulting from specific page requests on a VIO 
window, as well as those pages stolen by the paging 
supervisor as a result of infrequent use. It does not include 
VIO swap-outs or page-outs for the common area. 





SMF4SST binary OUXBJBS + Step service, in service units. This field is calculated as: 
OUXBTRS total iob service minus the accumulated job service prior to 
this step’s initialization.? 
+32 SMF4ACT binary | OUXBJBT + Step transaction active time, in 1024-microsecond units. 
OUXBTRT Calculated as: total job transaction active tima minus the 
accumulated transaction active time prior to this step’s 
initialization.? 





+36 


8 
= ee ee 


binary | OUCBNPG Step performance group numbar (takan from PERFORM= 
parameter on JOB or EXEC card or the RESET operator 
command).? 
+38 SMF4TRAN binary | OUXBJBR + Step transaction residency tima, in 1024-microsecond 
OUXBTRR units. That is the ammount of time the transaction was in 
raal storage. 


+42| |SMF4RECL | 4 |binary | OUXBPREC Number of reclaims for private areas in this stap 
+45; |SMF4RCLM | 4 [binary | OUXBVAMR Number of VIO raclaims for this step 


+50| | SMF4CPGN | 4 |binary | OUXBCAPI Number of common area page-ins for this step (LPA + CSA) 
+54] | SMF4CRCL | 4 |binary | OUXBCAPR Number of common ares reclaims for this stap (LPA + CSA) 


+58] |SMF4PGST | 4 |binary | OUXBSTCT Number of pages stolan from the storage for this stap 


of SMF4PSEC tae aad OUCBPSS Number of page seconds for this stap, in. page millisecond 


units. Calculated as: the number of pages used by this stap 

times the execution time it held that number of pages. 
+70| |SMF4LPAI_ | 4 [binary | OUXBLPAI | Number of link pack area page-ins for the step 
+74[|SMF4LPAR | 4 [binary | OUXBLPAR | Number of link pack area reclaims for the stp 


7a] [Saracrus | 4 [Bian | Guxercru 
SMF4IOCS binary OUXBJIOC + Step |/O service, in service units? 
OUXBTIOC 
+86 binary OUXBJMSO + Step main storage service, in service units? 
OU XBTMSO 
rare | P| ouxersne 
i al ae 


9 For more information on service, transaction active time, and performance group number, 
see /nitialization and Tuning. 
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C Record Type 5 (05) — Job Termination 


Record type 5 is constructed by IEFTB722 and written by IEFTB721 at the 
normal or abnormal termination of a background job. Its length is 137 bytes plus 
the length of the job accounting fields. (The maximum length of this record is 
281 bytes.) 


This record identifies the job by job log identification, user identification, 
priority, input class, and programmer's name. If accounting numbers (which can be 
alphameric) were specified in the JOB statement, they are included. 


This record also contains operating information such as the job start and end times, 
number of steps in the job, number of records in DD DATA and DD* data sets for 
the job, job termination status, device class, unit type, storage protect key, job 
service and job CPU time. (The job CPU time equals the sum of the job step times.) 


Note: For more information on EXCP count and CPU time, see Chapters 8 and 9, 
respectively. 


The format is: 


































a _ ee 
EELy SMFSLEN | 2 [binary | internal | Record length 
2 1 se F5FLG binary SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
VS1 
rs [= [sweenry | 1 [piney [interna 
binary | SVC 83 Time, in hundredths of a second, record is passed to the 
SMF writer. This is the time the job terminated. 
SMF5DTE packed | SVC 83 Date, in the form OOY YDODF, where F is the sign, record is 
terminated. 
ea [tram | 5s] a 
SMF5RST binary | JMRENTRY Time, in hundredths of a second, reader recognized the JOB 
card for this job+ 
packed | JMREDATE Date reader recognized the JOB card ee this job, in the 
form OOYYDDDF where F is the sign? 
SMF5UIF JMRUSEIJD User identification (taken from common exit parameter 
area) 
SMF5JIT binary JCTJMRJT cit a by | Time, in EL hel of a second, initiator selected the job 
lIEFSMFIE) 
47 SMF5JID packed | JCTJMRJD (Set by | Date initiator selected the job, in the form OOY YDDDF 
IEFSMFIE) where F is the sign 
binary | JMRJOBIN Number of card-image records in DD DATA and DD® data 
sets read by the reader for the job 
1The job name and the time and date that the reader recognized the JOB card for this job constitute the (Continued) 


[SMFSSEG | _2 [binary | internal __|_Segment descriptor 
6 VS2 
passed to the SMF writer. This is the date the job 
'SMF5SID | 4  |EBCDIC| JMRCPUID System identification (taken from SID parameter) 
42 | 2A) SMF5NST | 1 | binary | |binary — }JMRSTEP Number of steps in the | Number of stepsinthejob 
( job log identification. 
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[ors [Name [teva [Former [Soweto 


| SMF5JCC | TCBCMPC Job completion code: 
while being scheduled, this field equals 14 (taken from 


X’Occc’ indicates systam ABEND in the last job step where 
ccc is the system ABEND code (see System Codes). 
X'8ccc’ indicates user ABEND in the last job step where ccc 
is the user ABEND code. 
SMFSJPTY binary | JCTJPRTY 
the PRTY parameter on the JOB card).? 
SMF5RSTT binary | JMRDASTP Time, in hundredths of a second, reader recognized the end 
of the job.4 
SMFS5RSTD packed | JMRDASTP + 4 Date reader recognized the end of the job, in the form 
OOY YDDDF where F is the sign.4 
SMF5JBTI binary Job termination indicator 
JCTJMRCL 
JCTJMACL 
JCTJIMRCL 
If 0, normal compietion. If 1, ABEND. 
Reserved 


X‘nnnn’ indicates normal completion where nnnn is the 
contents of the two low-order bytes in register 15 at 
termination. 
X‘0000' indicates normal job completion with a return 

code of 0.2 
ov [as [swrssmer | 1 [eimy | id Rees 
SMF5TRAN binary | OUXBJBR + Job transaction residency time, in 1024-microsecond units. 
OUXBTRR That is the total amount of time the transaction was in 
real storage.° 
a [aa [swrscKne [1 [bin | sid Rowe SC 
73 SMF5RDCL binary | JMRADR Reader device class. (This field is not filled in for jobs 
submitted via an internal reader.) 
74 SMF5RUTY binary | JMRRDR Reader unit type. (This field is not filled in for jobs 
submitted via an internal reader.) 


Use this field in conjunction with the job termination 
indicator field (offset 66). 
2 When a step in a multi-step job terminates abnormally, the subsequent steps, whether executed or flushed, do 
not propagate the step abend code for processing by this record. The code appears in the step termination 
record (type 4). In this cass, the field, offset 55, can contain X‘nnnn’ or X’‘0000’: the job termination 
indicator (offset 65, bit 6) is set to 1 if an abend occurred in the job. 
31 no value is specified for the PRT Y parameter on the JOB card, this field contains: 
e For JES3, the default priority specified on the JES3 STANDARDS initialization card 
e For JES2, a zero. 
Note that JES2 does not use the priority value reported in this field. 
















Job selection priqrity. This field normally equals the 
user-assigned priority of 0 to 13, but if the job fails 

















Bit Meaning When Set 

0 Reserved 

1 Canceled by exit [IEFUJV 
2 Canceled by exit IEFUJI 
3 Canceled by exit [EFUSI 
4 

5 

6 

7 






Canceled by exit IEFACTRT (step exit only) 
Reserved 













(Continued) 


41 the job that is terminating is ‘JES2’ or ‘JES3’ then this field might be set to zero. 


SFor more information on service, transaction active time, and performance group number, see /nitialization and Tuning. 
- “ 4 - 
Note that the service, active time, and residency time may have been accumulated under different performance group 
numbers. 
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/75|4B|SMFBJICL | 1  |EBCDIC| JCTICSMF Job input class (taken from JOB card; default equals ‘A‘) 
76 | 4C 1 binary | TCBPKF Storage protect key, in the form xxxx0000 where xxxx 
is the key 
77 SMF5SRBT binary | SCTSRBT Job CPU time under SRBs, jn hundrecths of a second. This 
thet are dispatched vie SRBs: locking routines, page 
resolution, swap control, cross-memory communications 
(WAIT, POST, I/O POST), and TQE scheduling. § 
SMESTTAT. binary | OUXBJBT + Job transaction active time, in 1024-microsecond units > 
OUXBTRT 
aiid sursnva | |emev | —sidiRewnes SSCS 
5C binary |OUCBNPG Performance group number of last step (taken from 
of a RESET or SET IPS command)® 
}96|60]}SMFSTLEN | 1 |binary | ACTLEN ———— JCT) _ | Length of rest of the fixed portion of the record 
117) 75 | SMF5JCPU binary |ACTJTIME (in JCT) | Job CPU time under TCBs, in hundredths of a second. 
This field includes the CPU time for all tasks that are 
dispatched via TCBs below the level of RCT.® 
79 | SMFS5JSAF | variable |EBCDIC | JOB statement Accounting fields. Each entry for an accounting field 
contains the length of the field (one byte, binary) followed 
by the field (EBCDIC). A zero indicates an omitted field. 
Relocate Section: 
SMFS5CPUS binary |OUXBJCPU + Job CPU servics, in service units” 
OUXBTCPU 
+4 SMF5IOCS binary | OUXBJIOC + Job 1/O sarvica, in service units” 
OUXBTIOC 
+12 binary |OUXBJSRB + Job SRB sarvics, in service units? 
OUXBTSRB 
2For more information On service, transaction active time, and performance group number, see /nitialization and Tuning. 
Note that the service, active time, and residency time may have been accumulated under different performance group 


[Offsets | Name | Length | Format] == Source =| ‘mmeription 
field includes the CPU time for various supervisory routines 
SMFSTJS OUXBJBS + Job service, in service units > 
OUXBTRS 
PERFORM= parameter on JOB or EXEC card or the result 
rea [se | Swrenva | 2 [binary 
120] 78 | SMF5acTF | 1 — [binary | ACTJNFLD (in JCT)| Number of accounting fields 
+8 binary |OUXBJMSO + Job main storage service, in service units 
OUXBTMSO 
numbers. 


Bcpu time may not be constant between different runs of the same job. For more information on CPU time, see 
Chapter 9. 
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Record Type 6 (06) — JES2 Output Writer 





Record type 6 is written by HASPPRPU (JES2 writer), The JES2 writer writes this 
record when processing is completed for a job output element (JOE), or when there 
is a change in certain information (indicated by “*’’) describing SYSOUT data sets 
processed in the same JOE. If a printer is running under the control of a functional 
subsystem (FSS), record type 6 is written for each data set printed on that printer. 
This record is also written for spin data sets. If the JES2 writer is used, the record 
length is 94 bytes plus 36 bytes for the 3800 (non-impact) printing subsystem sec- 
tion and 14 bytes for the routing section. (Note: If an external writer or user- 
supplied writer is used, the length is 88 bytes. See “Record Type 6 (06) — External 
Writer” for more information.) 


This record identifies the output writer by SYSOUT class and form number, and 
identifies the job according to job log identification, JES2-assigned job number, 
and user identification. It also contains information on the output writer activity 
such as the number of logical records processed, number of data sets processed, 
writer start and end times, input/output status indicators, data set control indica- 
tors, and JES2 logical output device name. 


This record also provides information on the activity of the 3800 (non-impact) 
printing subsystem. For additional information on the 3800 printer, see the JBM 
3800 Printing Subsystem Programmer’s Guide. 


The format is: 


ote smes.en | 2 | inary | internal | Ror anat 
° VS2 


SMF6FLG binary SVC 83 System indicator 
Reserved 


SMFETME binary SVC 83 Time, in hundredths of a second record was Moved to 
SMF buffer 
A SMF6DTE packed SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


4 [e | swresio | 4 | escoic | smcasio System identification (taken from SID parameter 


















Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
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SS | Name | p Deweription 


2 SMF6RST binary JCTRDRON Time, in hundredths of a second, reader recognized the 
JOB card for this job1 
SMF6RSD packed JCTRDTON Date reader recognized the JOB card for this job in the 
form OOYYDDDF where F is the sign! 
SMF6UIF EBCDIC | JCTUSEID User identification (taken from common exit parameter 
area) 
2A SMF60WC EBCDIC | JOECURCL *SYSOUT class. (This field is blank for nonSYSOUT 
data sets. ) 
SMF6WST binary PITMEON {in Start time, in hundredths of a second, of print/punch 
PPPWORK)2 processor working on the data in this record 
47 2F SMF6EWSD packed PTIMEON +4 Start date of print/punch processor working on the data 
(in PPPWORK)2 in this record, in the form OOY YDDDF where F is the 
SMF6ENLR binary 
number and class. (This field includes JOBLOG informa- 
tion and data set copies.) 


sign 
37 SMF61OE binary PPFLAG (in I/O status indicators 
2 
PPPWORK) Bit Meaning When Set 

0-4 Reserved 
*5 Data buffer read error 
6 Reserved 
*7 Control buffer read error 

SMF6NDS binary PPJNDS (in Number of data sets processed by the writer and included 

PPPWORK)2 in this record. If multiple copies are produced, each copy 
is not counted. (This field includes JOBLOG information.) 
57 SMF6FMN EBCDIC | DCTFORMS 

appears only in SMFGEFMN, described under the JES2 
Routing Section later in this record. 

SMF6PAD1 binary UCBTYP Section indicator 
Bit Meaning When Set 
0 3800 printing subsystem section present 
1 Routing section present 
2-7 Reserved 

62 | 3E | SMF6SBS | 2 | binary | internal internal ‘| Subsystem identification — X’0002’ signifies JES2 


SMF6LN1 binary internal Length of rest of record, including this field, but not 
including any additional sections indicated by the 
SMF6PAD1 field 


IThe job name and the time and date that the reader recognized the JOB card for this job constitute the job log identification. 
PPPWORK is the print/punch processor work area. 




















PPLNCDCT 
(in PPPWORK)2 


Number of logical records written by the writer, by form 





























Output form number. If the source field contains four or 
fewer characters, SMFGFMN will be set. Otherwise, this 
field contains blanks and the contents of the source field 








* A change in this field will cause a new record type 6 to be written. 
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[ors [none [tomo [rare [somes [mon 


42 SMF6DCI binary PSMFDCI (in Data set control indicators 
PPPWORK)! j Meaning When Set 
Reserved 
Record represents spin data sets 
Operator terminated this data group 
Operator interrupted this data group 
Operator restarted this data group 
Record represents continuation of interrupted 
data group 
Operator overrode programmed carriage control 
(printer only) 
Punch output was interpreted (3525 only) 








67 | 43 SMF6INDC binary internal Record level indicator2 
Bit Meaning When Set 
0-3 Reserved 
4-7 A value of X’01’ indicates the first level of the 
restructured SMF type 6 record for JES2 Version 
2 Release 1.5. 


1 
)smr6inm | 4 | epcDic | JcTJOBID +4 JES2-assigned job number 
74a swreour | @ | E80DIc | DCTDEVN | JES2iogial output devcerame 
eo [s | swrercs [4 | eecoic | ocrrca | “FCB imegeidentication orinwron) 
| 84 [54 |smreucs | 4 | eBcDIC | DcTUCS —_| *UCS image identification (printer only) 
| SMFGPGE | 4 | binary | PRPAGECT/+0 Approximate page count (printer only)3 (in PPPWORK)1 


92 SMF6RTE DCTNO Output route code4 


PPPWORK is the print/punch processor work area. 
Each time the record is changed, the value of this field is increased by 1. 
For a printer controlled by JES2, the count is updated: 


N — 


@ On askip to any channel instruction if LINECT=0 is specified on the JOBPARM JECL statement, in the accounting field of the 
JOB statement, on the OUTPUT JECL statement, or on the OUTPUT JCL statement 


e Afterthe number of lines specified in LINECT or a skip to any channel instruction is reached 


For a printer controlled by an FSS, the count is affected by one or more of the following: 
e A PAGEDEF statement 
e A FORMDEF statement 
e The presence of page mode data 
Arhis field is defined as follows: X’0100’ indicates local routine: X’nnrr’ (where nn is the node number and rr is the remote device 


within that node) indicates remote routine; and X’00nn’ indicates special jocal routing. If more than 255 remotes are specified for the 
system, this field is set to zero. 


*A change in this field will cause a new type 6 record to be written. 
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J 





erie [nine [ese] Fore [ee [Rae 


3800 (non-impact) Printing Subsystem Section: 


SMF6ELN2 i internal Length of 3800 printing subsystem section, including this 
field 


SMFE6CPS binary PCOPYGRP (in *Number of copies in each copy group. Each byte repre- 
PPPWORK)1 sents One copy group, and the sum of the 8 bytes is the 
total number of copies printed. 
SMF6CHR EBCDIC | DCTCHART, 2, *Names of the character arrangement tables 
3,4 that define the characters used In printing. Each name is 
4 bytes long, with amaximum of 4 nemes. 
a EBCDIC | DCTMODF * Names of the copy modification module used to modify 
the data 


| SMF6FLI LI | EBCDIC | | DCTFLASH LASH *Name of the forms | *Name of the forms overlay printed onthe copies =| printed on the | *Name of the forms overlay printed onthe copies =| 


SM SFr LC co DCTFLASH LASHC *Number of copies on which the forms overlay is printed 
(in PPPWORK)1 


SMF6BID binary Options indicator 
Bit Meaning When Set 

DCTPPSW2 *O Output was burst into sheets by the Burster- 
Trimmer-Stacker 

PPF LAG2 *1 DCB subparameter OPT CD=J was specified. Each 

(in PPPWORK)1 output data line contained a table reference 
character that selected the character arrangement 
table used when printing that line. 
Reserved 


JES2 Routing Section: 
0 0 SMF6ELN3 binary internal Length of routing section (including this field) 


P2 [2 | SMF6ROUT | 4 | binary DCTNO Output route code2 
EBCDIC | DCTFORMS Output form number. This field is set regerdiess of the 
number of characters in the forms field (SMFGFMN) 


* A change in this field will cause a new type 6 record to be written. 





| PPPWORK is the print/punch processor work area. 


2 This field is defined as follows: X’00010000' indicates local routing; X‘nnnnrrrr’ (where nnnn is the node number and rrrr is the 


remote device within that node) indicates remote routine; and X'000Q0nnnn‘’ indicates special local routing. This field is always set 
regardless of the number of remotes specified by the system. 
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Record Type 6 (06) — External Writer 


Record type 6 is written by [ASXSD82 (external writer). The external writer writes 
this record when processing is completed for a job output element (JOE). If a 
printer is running under the control of a functional subsystem (FSS), record type 

6 is written for each data set printed on that printer. 


This record identifies the output writer by SYSOUT class and form number, and 
identifies the job according to job log identification, JES2-assigned job number, and 
user identification. It also contains information on the output writer activity such 
as the number of data sets processed, and the FCB and universal character set 
identification for the printer. 


If an external writer or user-supplied writer is used, SMF produces an incomplete 
record type 6. SMF produces this incomplete record only when the external writer 
directs output to a printer or punch. If the external writer directs output to a tape 
or disk, then SMF does not produce this record. The incomplete record type 6 
differs from the JES2 record type as follows: 


e Its length is 88 bytes — offsets 88 and 92 are not produced. 


e The following fields are zero: 

— The number of logical records (offset 51) 

— ]/O status indicators (offset 55) 

— Subsystem generating identification (offset 62) 
Data set control indicators (offset 66) 
JES2 logical output device name (offset 72) 


Its format is: 


a 


om SMFOLEN 2 | sire | iene Record length 


SMFG6FLG binary SVC 83 System indicator 
Reserved 


SM | SMFGRTY | | binary | | internal | Recordtvpe = iss—‘—sSCid | Recordtvpe = iss—‘—sSCid 


SM Sure binary ernst 83 Time, in hundredths of a second, record was moved to 
SMF buffer 


SMF6DTE packed SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 
14] E | SMF6SI|D 4 EBCDIC SMCASID System identification (taken from SID parameter) 













Bit Meaning When Set 






0-4 Reserved 
5 MVS/XA 
6 VS2 
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SMF6JBN EBCDIC | SSSOJOBN Job ee 
(in SSOB) 
SMF6RST binary job log? +4 Time, in hundredths of a second, reader recognized the 
JOB card for this job1 
 SMFERSD F6ERSD pac ked job log2 +8 Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign 
SM ww EBCDIC | job log? +12 User identification (taken from common exit paremeter 
area) 
SMF6EOWC EBCDIC | SSSOCLAS SYSOUT class. This field is blank for non-SYSOUT data 
(in SSOB) sets.) 
SMF6EWST binary SVC 11 (set by Start time, in hundredths of a second, of print/punch 
IASXSD82) processor working on the dats in this record 
47 2F SMF6EWSD packed SVC 11 (set by Start date of print/punch processor working on the data 
|ASXSD82) in this record, in the form OOY YDDDF where F is the 
sign 


NN 


SM Susie binary Number of data sets processed by the writer and included 
in this record. If multiple copies are produced, each copy 
is counted. (This field included JOBLOG information.) 

57 SMF6FMN EBCDIC | SSSOFORM Form number 
— SSOB) 
| 61 | 3D- SMF6PAD1 | 1 | binary | binary | Reserved 


ate SMF6SBS i Subsystem identification (x‘0000’ indicates external 
writer) 


SM ) SMFELN1 ) SMFELN1 | binary | J internal Length of rest of record, including this field 
SMFEDCI SEE X0000" indicates external writer 


SMF6JNM EBCDIC | JCTJOBID +4 JES2-assigned job number 
(in SSOB) 


| 72 | 48 | smréout | 8 | EBcDIC| DCTDEVN X'0000’ indicates external writer 
| g0 | 50 | smFeércB | 4 | EBCDIC| DCTFCB FCB image identification (printer only) 


| 84 | 54 SMF6UCS pa EBcDIC | DcTUCS UCS image Identification (printer only) 


1 





The job name and the time and date that the reader recognized the JOB card for this job constitute job log identification. 
The job log is pointed to by SSSOWTRC field in the SSOB data area. 
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Record Type 6 (06) — JES3 Output Writer 


Record type 6 is writted by IATOSWD for each data set processed by JES3 output 
service. One type 6 record is written for each copy with a given form name. If a 
printer is running under the control of a functional subsystem (FSS), record type 6 
is written on the processor with the FSS address space for each data set printed on 
that printer. This record is also written for spin data sets. Its length is 116 bytes 
plus 36 bytes for the 3800 (non-impact) printing subsystem section, and 14 bytes 
for the routing section. 


This record identifies the output writer by SYSOUT class and form number, and 
identifies the job according to job log identification, JES3-assigned job number, 
and user identification. It also contains information on the output writer activity 
such as the number of logical records processed, number of data sets processed, 
output service start time and date, I/O status indicators, data set control indicators, 
JES3 logical output device name, and output activity. 


This record also provides information on the activity of the 3800 printing (non- 
impact) subsystem. For additional information on the 3800 printer, see the JBM 
3800 Printing Subsystem Programmer’s Guide. 


The format is: 


0 
To [wis [4 [sere [hc 


SMF6FLG tiny SVC 83 System indicator 
Bit Meaning When Set 
Reserved 
MVS/XA 
VS2 
Reserved 


SM | SMFG6ATY | | binary Record type 


Surety FETME binary SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 

SMF6DTE packed SVC 83 Date record was moved to SMF buffer in the form 
OOYYDDDF where F is the sign 


| EBCDIC | |JMRCPUID System identification (taken from S|D parameter) 
2 ee SMF6JBN eee | EBCDIC |RQJOBNAM — Job name! (taken from job’s RESQ) 


SMF6RST binary ROsOBNAM _ macro] Time, in hundredths of a second, reader recognized the 

(Set by IATISJB) | JOB card for this job! 
packed JMREDATE macro | Date reader recognized the JOB cerd for thisjob, In the 

(Set by |ATISJB) form OOY YDDDF where F is the sign! 

SMF6UIF EBCDIC | JMRUSEID Usar identification (teken from common exit paremeter 
(Set by IATOSWD) | area) 

2) 28 SMF6OWC ot EBCDIC | OSECLASS SYSOUT class, (This field is blank for non-SYSOUT deta 
sets.) 


SMF6EWST binary |IATXTOD macro Start time, in hundredths of a second, of output service 
(Set by IATOSWP) | working on the deta In this record. This field is filled 
in at JES3 LOGIN time for the writer job. 
ee ie |IATXTOD macro Stert date of output service working on the data in this 


(Set by IATOSWP) | record, in the form OOY YDDDF where F is the sign. This 
IThe job name and the time and date that the reader recognized the JOB card for this job log identification. 





































field is filled in at JES3 LOGIN time for the writer job. 
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L 


el eee 


SMF6ENLR binary WTRDRCDS or Number of logical records written by the writer, by form 
PPQRCDCT number and class, (This field is filled in when a data set is 
completed or restarted; it includes repeats and restarts.) 


- i 
is counted. (This field is filled in.when data set is com- 


56 38 SMF6ENDS 1 binary WTRJCOPY or 
PPYSTCPY 
pleted or restarted; it does not include restarts. ) 
57 39 SMF6EFMN EBCDIC | SUPFORMS (in Form number — only the first 4 bytes appear in this 
SUPUNITS entry field. 
for the output 
device) 


61 3D SMF6PAD1 binary Section indicator 
Bit Meaning When Set 
|ATOSWP 3800 printing subsystem section present 
Routing section present 
Reserved 


SMF6SBS | 2 | binary | LATOSWP Subsystem identification — X‘0005’ signifies JES3 


SMF6LN1 binary }ATOSWP Length of rest of record, including this field, but not 
including any additional sections indicated by the 
SMF6PAD1 field 


SMF&DC]! binary |ATOSWP Data set control indicators (These bits are set when a data 
set is completed or restarted. ) 
] Meaning When Set 
Reserved 
Record represents spin data sets 
Operator terminated this data group 
Operator restarted data set with destination 
Operator restarted this data group 
Received operator restarted data set 
Operator started with single space 
Punch output was interpreted 


67 43 SMFSINDC 1 binary internal Record level indicator2 
Bit Meaning When Set 
0-3 Reserved 
4-7 A value of X‘01’ indicates the first level of the 
restructured SMF type 6 record for JES3 releases 
1.3.1, 1.3.4, and 2.1.5. 


SMFS&JNM EBCDIC | RQJNUM or JES3-assigned job number (taken from the job’s RESQ) 
IATOSWD 


72 SMF6EOUT EBCDIC | SUPDD (in JES3 logical output device name 

SUPUNITS entry 

for the output 

device) 

SMF6FCB EBCDIC | SUPCARR (in FCB image identification (printer only) 

SUPUNITS entry 

for the output 

device) 


2 Each time the record is changed, the value of this field is increased by 1. 












Bit Meaning When Set 
0-4 Reserved 

5 Data buffer read error 
6 Reserved 

Control buffer read error 


Number of data sets processed by the writer and included 
in this record. If multiple copies are produced, each copy 
















SOO SWN - OD 
ca 
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Tone [sw [ewe [rom [eee [ee 


SMF6UCS EBCDIC | SUPUCS {in UCS image identification (printer only) 
SUPUNITS entry 
for the output 
device) 
i SMF6PGE ee WTRDPGET For printer, approximate page count {A skip to carriage 


control channel one is counted as a page.) For punch, the 
| 7 Sf - 








number of cards punched. This field is filled in when a 
data set is completed or restarted 











Data format error indicators (These bits are set when a 
data set is completed or restarted. ) 





Bit Meaning When Set 

0-5 Reserved 

6 Some first character control data bad, default used 
7 Bad record length (truncate or pad) 

Reserved 







94 | SE | SMF6OPR | 2 | binary | OSEPRTY Output priority 


SMF6GRP EBCDIC | SUPGROUP {in JES3 logical output device group name 
SUPUNITS entry 
for the output 
device) 


| 104] 68 SMF6RSV\J |B EBCDIC P| Reserved for JES3 


3800 (non-impact) Printing Subsystem Section: 





SMF6LN2 binary |IATOSWP Length of 3800 printing subsystem section, including this 
field 


SMF6CPS binary OSEMODRC Number of copies printed in each copy group. Each byte 
represents one copy group, and the sum of the 8 bytes is 
the total number of copies printed. 

10 A SMF6ECHR 16 EBCDIC | OSECHARS Names of the character arrangement tables that define the 
characters used in printing. Each name is 4 bytes long, 
with a maximum of 4 names. 

1A SMF6MID EBCDIC | OSEMODID Name of the copy modification module used to modify 
the data. 
SMF6F LI EBCDIC | SUPFLASH or Name of the forms overlay printed on the copies 
PABFLASH 


| 34 | 22 | SMF6FLC pt | binary OSEFLCNT Number of copies on which the forms overlay is printed 


SMF6BID binary Options indicator 
j Meaning When Set 

OSESTACK Output was burst into sheets by the Burster- 
Trimmer-Stacker 

OSEDFLG1 DCB subparameter OPTCD=J was specified. Each 
output data line contained a table reference 
character that selected the character arrangement 
table used when printing that line. 
Reserved 


JES3 Routing Section: 
SMF6LN3 — — 1 of routing section (including this field) 


SMF6EFMN — SU a Revere form number. This field is set regardless of the 
number of characters in the forms field (SMFGEFMN) 
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Record Type 6 (06) — Print Services Facility (PSF) 


Record type 6 is written by APSPNST. PSF writes this record whenever data set 
processing is complete, that is, whenever the JES subsystem that PSF is running 
under is informed that the data set is to be released. Its length is 92 bytes plus 36 
bytes for the non-impact printing subsystem section, and 47 bytes for the all-points- 
addressable or APA printing subsystem section. 


The record identifies the output writer according to SYSOUT class form number 
and subsystem identification. It also identifies the job according to job log identifi- 
cation, JES-assigned job number, and user identification. In addition, it contains 
information on the output writer activity such as the number of logical records 
processed, writer start time, and input/output status indicators, logical output 


device name, and number of resources such as fonts, overlays, page segments, 
PAGEDEFs, and FORMDEEFs. 


This record provides information in separate sections on the activity of the non- 
impact printing subsystem, and information on the activity of the all-points- 
addressable (APA) printing subsystem. For additional information on the 3800 
printer, see the JBM 3800 Printing Subsystem Programmer's Guide. For more 
information on the 3800-3 or 3820 printers, see the section “Related Publications” 
in the PREFACE. 


The format is: 


-2 | 2 | smresec | 2 | binary | internal | Segment descriptor 
6 VS$2 


SMF6FLG binary SVC 83 System indicator 
7 =< 


SM ——. binary SVC 83 Time, in sg anne eeeorrcenar mere of a second, record was moved to 
SMF buffer 
SMF6DTE packed SVC 83 Date record was moved to SMF buffer in the form 
OOYYDDDF where F is the sign 
| SMF6SID _ | EBCDIC| JMRCPUID System identification (taken from SID parameter) 
a SMF6JBN i EBCDIC| JMRJOB Job name! (taken from job's RESQ) 


SMF6RST binary JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job! 
30 SMF6ERSD packed JMREDATE Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign! 


'The job name and the time and date that the reader recognized the JOB card for this job |og identification. 

















Bit Meaning When Set 
0-5 Reserved 
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EBCDIC}] JMRUSEID User identification (taken from common exit paramter 
area) 
2) 8 SMF6OWC ot EBCDIC| JSPJSOCL SYSOUT class. (This field is blank for non-SYSOUT 
data sets.) 


34 SMF6UIF 



















my —— ae — 
— aye — 
-_ pe — 


Start time, in hundredths of a second, of output service 
working on the data in this record. This field is filled in at 
JES3 LOGIN time for the writer job, 


Start date of output service working on the data in this 
record, in the form OOY YDDDF where F is the sign. This 
field is filled in at JES3 LOGIN time for the writer job. 


Number of logical records written by the writer, by form 
number and class. (This field is filled in when a data set is 
completed or restarted; it includes repeats and restarts.) 













Meaning When Set 


Reserved 
Data buffer read error 
Reserved 


37 SMF6IOE 1 binary DIAIOE |/O status indicators 
Bit ] 
0-4 
Control! buffer read error 











ats — ii 


| SMF6FMN | EBCDIC | | DIAFORM | 


SMF6SBS | 2 | binary binary | internal = 


Number of data sets processed by the writer and included 
in this record. If multiple copies are produced, each copy 
is not counted, 







Form number — only the first 4 bytes appear in this field 


= SN FSrN rerun | 4 _Sec0'e Dror Section indicator 
Reserved 


Meaning When Set 

Non-impact printing subsystem section present 
Reserved 

All-points-addressable (APA) printing subsystem 
section present 





Subsystem identification — X’0007' signifies PSF 


SMF6LN1 binary pew Length of rest of record, including this field, but not 
including any additional sections indicated by the 
SMF6PAD1 field 





NW QOOhWnN- OB 
os 





data set is completed or restarted.) 


SMF6DCI binary DIADCI Data set control indicators {These bits are set when a 
j Meaning When Set 
Reserved 
Record represents spin data sets 
Operator terminated this data group 
Operator restarted data set with destination 
Operator restarted this data group 
Received operator restarted data set 
Operator started with single space 
Punch output was interpreted 





Meaning When Set 
Reserved 


A value of X‘0O1’ indicates the first level of the 
restructured SMF type 6 record for PSF 1.0. 


SMF6INDC binary Record level indicator2 
Bit ] 
0-3 
4-7 nab ts . 
A value of X’02' indicates PSF 1.1. 





zach time the record is changed, the value of this field is increased by 1. 
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om [me _Sirn Preme [eee fees 
es | 44 SMF6JNM EBCDIC | JSPAJBID JES-assigned job number. 


72 SMF6OUT EBCDIC | CCBPCLBL JES-logical output device name. (For the 3820, ACF 
VTAM logical unit name.) 


}so0 | 50 | smrercB | 4 | | internal = | Reserved = | 
[ea [sa | sureucs ee 
88 | 58 | SMF6PGE | 4 | binary DIAPAGE Approximate physical page count 


Non-impact Printing Subsystem Section: 
SMF6LN2 
























Length of non-impact printing subsystem section, includ- 
ing this field 


internal 





binary 









Number of copies in each copy group. Each byte repre- 
sents one copy group, and the sum of the 8 bytes is the 
total number of copies printed. 












Names of the fonts that define the characters used in 


aa SMF6CPS a binary | DIACPYGP 
SMF6CHR EBCDIC | DIACHR 
printing as specified in the JCL. Each name is 4 bytes 
long, with a maximum of 4 names. 


ar SMF6FL| Za EBCDIC | DIAFLI Name of the forms overlay printed on the copies 
34 | 22- SMF6EFLC | 1 | binary DIAFLC Number of copies on which the forms overlay is printed 


35 23 SMF6BID binary DIABID Options indicator 
DIACSP 


All-Points-Addressable or APA Printing Subsystem Section: These fields contain meaningful data only if the All-points-addressable 
printing subsystem is running under the control of print services facility (PSF). 













Meaning When Set 







0 Output was burst into sheets by the Burster- 
Trimmer-Stacker 
1 DCB subparameter OPTCD=J was specified. Each 





output data line contained a table reference 
charecter that selected the font used when print- 
ing thet line. 

2 Cut-sheet printer? 

Reserved 










SMF6LN4 binary internal Length of the section (including this field) 


Fe 
ca [| swreront| 4 | inary | OVAFNTCT | Number offortwumd 


)s |B) SMF6LENT | 4 | binary DIALFTCT Number of fonts loaded 
12] ce SMF6OVLY | 1 | binary — DIAOVLCT Number of overlays used 


3 






This field is valid only when SMF6SBS equals x‘0007', and SMF6INDC is equal to or greater than x’02’. 
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bane SMF6PGSG me D | DISPSCT) Number of page segments used 
SMF6 | SMF6LPSG | | packed — | packed — -2sser IALPSCT Number of page segments loaded 


SAFSLPSS binary DIASHEET Number of sides of sheets of paper printed (number of 
logical impressions? 


| 32 | 20 | SMF6FEET | 4 | binary | DIAFEET Number of feet of document printed. (Zero for the 3820.) 
=" SMF6PGDF | 4 | binary — DIAPGDEF Number PAGEFDEFs used 
“0 | 26 SMF6FMDF | 4 | binary | DIAFMDEF Number FORMDEFs used 


SMF6BIN binary Bin indicators 
Bit Meaning Whan Set 
| 7 pp 


0 Bin 1 used for any part of the data set 
Sthis field is valid only when SMF6SBS equals x’0007’, and SMFG6INDC is equal to or greater than x’02’. 
















1 Bin 2 used for any part of the data set 
2-7 Reserved 









Duplex indicators 






Bit Meaning When Set 

0 Standard duplex was ‘used for any part of the data 
set 

1 Tumble duplex was used for any part of the data 
set 

2-15 Reserved 
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Record Type 7 (07) — Data Lost 


Record type 7 is the first record built when an SMF data set becomes available for 
recording after a period when no data sets were available. Data existing in the SMF 
buffer is written to the newly available SMF data set before record type 7 is built in 
the buffer. Consequently record type 7 is not the first record in the data set. It is 
written by IEEMB8729 and its length is 28 bytes. 


This record contains a count of the SMF records that were not written, and the 
start and end times of the period during which no records were written. (The end 
time is the time recorded in offset 6.) 


The format is: 


[otis [Name [tenth [Format | Sowes [——~S~*~i erento 
(0 | 0 | smr7Len | 2 [binary internal | Record length 
Tsme7seG | 2 Joinery internat | Sopment descriptor OSS 


eee 
SMF7FLG binary ||EEMB8829 System indicator 
| Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
6 VS2 
| VS1 
om [binary internal 


7 
Pee SMF7RTY | 4 [binary | Record type 


SMF7TME binary |SVC 11 (Set by Time, in hundredths of a second, record was built in SMF 
|EEMB829) buffer 
SMF7DTE packed {SVC 11 (Set by Date record was built in SMF buffer, in the form 
}1EEMB829) OOY YDDDF where F is the sign 
14 | © | smF7sip | 4  |escpic|smcasiD —_|_ System identification (taken from SID parameter) 


SMF7NRO binary |SMCADSCT Number of SMF records lost because no SMF data sets were 
available for recording 
SMF7STM binary |SMCADSTM (Set by | Start time, in hundredths of a second, of period during 
1EEMB829) which no SMF data sets were available for recording 
SMF7STD a packed |SMCADSTM (Set by | Start date of period during which no SMF data sets were 


































{EEMB829) available for recording, in the form OOYYDDDF where F 
is the sign 
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Record Type 8 (08) — I/O Configuration 





Record type 8 is written by IEEMB823 after the IPL of the system is completed and 
the SET DATE operator command is issued. This record identifies each device that 
is online at IPL by device class, unit type, and device number. Its length is 20 bytes 
plus four bytes for each device online at IPL. 


The format is: 























| Ofteets | Name | Length | Format | Source Description 
eee ee ee 
[binary [internal | Segment descriptor 
Sees ee SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
: VS2 
VS1 
Ts [5 | swranty | 1 [binary [internal | Record type 
binary |SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 
SMF8DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF where F is the sign 
4 [_& | srasio [4 [EacDIC|SMCASID | System identification (taken from SID parameter 
18 | 12 | SMF8LENN | 2 | binary [internal Length of rest of record including this field 
For each online device, there is a four-byte entry with the following format: 
SMF8IODV UCBTBYT3 
UCBTBYT4 
UCBCHAN 







Device class 
Unit type 


Device number. 
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Record Type 9 (09) — VARY Device ONLINE 


Record type 9 is written by ICB2MSG (for the 3850 Mass Storage Control), 
IEECLEAN, IEEVPTH, and IEE2303D when a VARY Device ONLINE command 
is processed. This record identifies the device being added to the configuration by 
device class, unit type, and device number. Its length is 20 bytes plus four bytes 
for each device varied online. 


The format is: 


Offsets | Name | Length | Format | Source] Description 
oO | o | smroven | 2 | binary |internai | Record length 
2] 2 | smrosec | 2 [binary | internal | Segment descriptor 


SMFSFLG binary |SVC 83 System indicator 
Bit Meaning When Set 
04 Reserved 
MVS/XA 
VS2 
VSi 


SM FOTME binary |SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 
SMFSDTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 
ia [& | smresio [4 | EBcDIG|SMCASID | _ System identification (taken from SID parameter 
18 | 12 | SMF9LENN | 2 | binary [internal Length of rest of record including this field 


For each device varied online, there is a four-byte entry with the following format: 
SMF9DVAD UCBTBYT3 Device class 
UCBTBYT4 Unit type 
UCBCHAN Device number. 
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Record Type 10 (0A) — Allocation Recovery 


Record type 10 is written by IEFAB488 after a successful device allocation recovery 
Its length is 44 bytes plus four bytes for each device entry. 


This record identifies the device that is made available by device class, unit type, 
channel address, and unit address. It identifies the job requiring the allocation 
job log identification and user identification. 


Note: This record is not produced if the operator cancels the job instead of 
attempting recovery. 























The format is: 
[ori [name [town [ Fore | Sowee  Demwiton 
ees ee 
2 | SETSES | 2 _[einery {eens Segment descriptor 
SMF10FLG binary |SVC 83 System indicator 
Bit Meaning When Set 
O04 Reserved 
5 MVS/XA 
6 VS2 
amen feren 
/5 | 5 | SMFIORTY| 1 [binary |internst = | Recordtype = = | 
SMF10TME binary |SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 
SMF 10DTE packed |SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF where F is the sign 
SMF 10SID a | EBCDIC |SMCASID System identification (taken from SID parameter) 
SMF10JBN EBCDIC | JMRJOB Job name. This field contains blanks if allocation recovery 
is for a system task 1 
SMF10RST binary |JMRENTRY Time, in hundredths of a second, reader recognized the JOB 
card for this job. one field equals zero if allocation recovery. 
is for a system task ? 
packed |JMREDATE Date reader recognized the JOB card for this job, in the form 
OOYYDDDF where F is the sign. This Meld equals zero if 
allocation recovery is for a system task 2 
hail least SMF 10UIF Le | EBCDIC | JMRUSEID User identification (taken from common exit parameter 
area) 
42 | 20 _ SMF10LN | 2 | binary |internsl Length of rest of record including this field 
For each device made available, there is a four-byte entry with the following format: 
SMF10DEV UCBTBYT3 
UCBTBYT4 
UCBCHAN 










Device class 






Unit type 






Device number. 
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Record Type 11 (OB) — VARY Device OFFLINE 


Record type 11 is written when a VARY Device OFFLINE command is processed. 
It is written by ICB2MSG (for the 3850 Mass Storage Control), IEECLEAN, 
JEEVPTH, [EFAB421, IGCOOOSI, and IGCO905I. This record identifies the device 
being removed from the configuration by device class, unit type, and device number. 
Its length is 20 bytes plus four bytes for each device varied offline. 


The format is: 


Tore [Nene [erat [Format | Souree [SSC ton 
St Suen 2 fama finernal [ Bacon oe 
(2 | 2 | SMFIISEG [| 2 | binary | internal | Segmantdescriptor 


SMF11FLG binary System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
° VS2 
Reserved 


rss | sweaty [1 [binary [internat | Record OOOSOSCSC—~—S 


SMF11TME binary |SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 

SMF11DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


| smrvisio | 4 | escoic| SMCASID System identification (taken from SID parameter) 
a SMFIILN | 2 | binery |intarnai | __Length of rest of record including this field 


For each device varied offline, there is a four-byta entry with the foliowing format: 





+0 SMF11DEV 1 binary UCBTBYT3 Device class 
+1 1 binary UCBTBYT4 Unit type 
+2 2 binary | UCBCHAN Device number 
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Record Type 14 (OE) — INPUT or RDBACK Data Set Activity 


Record type 14 is written for non-VSAM direct access or tape data sets that are 

| defined by DD statements or dynamic allocation and opened for INPUT or 
RDBACK processing by problem programs. It is written by IFGO202H and 
IFGO202I when a data set, as described above, is closed or processed by EOV. Its 
length varies from 292 to 6,416 bytes, depending upon the number of volumes for 
the data set. 


This record contains information (associated with both the access method used 
and the type of data set used) from the TIOT, JFCB, DCB, DEB, and UCB data 
areas. For more information about these data areas, see Debugging Handbook. 


Note: Record type 14 is not written for a data set defined by a DD* or DD DATA 
statement. For accounting purposes, the card-image count for these data sets is 
provided in record type 4. 


The format is: 































ee 
0-4 Reserved 
SMF 14TME binary SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 
packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOY YDDDF where F is the sign 2 


Ee SMF14LEN iain rene _ Record length 
5 MVS/XA 
SMF14DTE packed |SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF where F is the sign 
| SMF14UID | 14UID }EBCDIC|JMRUSEID | User identification (taken from common exit parameter area) 


| 2 (| binary — internal Segment descriptor 
6 VS2 
Se JMRCPUID System identification (taken from SID parameter) 


ee LG binary retest ___ 83 System indicator 
VS1 
— /EBCDIC|JMRJOB | Jobnamee sss | Jobnamee sss 
1The job name and the time and date that the reader recognized the JOB (Continued) 


Bit Meaning When Set 
(5 [| 5 | smMFiAty | 1 | binary internal 
SME TALON 2 _| secnie mrso8 Time, in hundredths of a second, reader recognized the 
JOB card for this job } 
card for this job constitute the job log identification. 





Record and data set indicator 


Bit Meaning When Set 

0 Reserved 

1 Record written by EOV (Register 14=0 if CLOSE; 
register 14=4 if EOV) 

2 DASD device 

3 Temporary data set. (A data set is temporary if it 
has a system-generated name, is created within a job 
or job step, and exists only for the duration of that 
job or job step.) 

4 DCBDSORG=DA. (The data set organization being 
used is direct access.) 

5 DCBSORG=!S and DCBMACRF not EXCP. (The 
data set organization being used is indexed sequential 
and the EXCP access method is not being used.) 

6 JFCDSORG=2IS. (The data set organization being 
used is indexed sequential.) 

7 VIO data set 

8-15 Reserved 









internal 











UCBTYP 
JFCBDSNM 






DCBDSORG 














DCBDSORG 









JFCDSORG 
(in JECB) 
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C Offers | Name [Length | Format | Source [| Deseription 


Section Sizes: 
SMF 14SDC binary Size of DCB/DEB section, This field equais 24. 


T 7 fe 


as [ae | swevasuc | 1 [einery [internat 


Wall aac a 


TIOT Section — a portion of the TIOT, including: 
SMFTIOE1 i TIOELNGH 


“e _ oe _ 





Number of UCB sections. There is aiways one UCB section 
for each UCB currentiy processing except for ISAM and 
BPAM-concatenated data sets. For ISAM data sets, this 
field is caiculated as: one for the index extent, one per 
volume for primary extents, and one for the overflow extent. 
For BPAM-concatenated data sets, there is one UCB section 
for each Gata set in the concatenated Cata set. 











| Size of each UCB section. This fieldequals 24. of each UCB section. This field | Size of each UCB section. This fieldequals 24. 24. 


Size of ISAM extension section. This field equals 28 
(or O if there ara no ISAM data sets). 


Time, in hundredths of a second, when the data set was 
opened. 







Length, in bytes, of the DD entry (including all device 
entries) 





Status indicator. This field indicates the tape label 
processing to be performed; whether unaliocating, 

rewinding, or unloading tape data sets is required; and 
whether this is the first DD entry for a split cylinder. 





based lad SMFTIOE3 ae endl TIOEWTCT Number of devices requested for this data set during 
allocation 


ie _ epee 


| SMFTIOES | | EBCDIC|TIOEDDNM 


ye _ inl -_ 





SMFDCBOR DCBDSORG 











During allocation, this field indicates a link to the 
appropriate prime split, unit affinity, volume affinity, or 
suballocate TIOT entry. After allocation, it is a data set 
and device indicator. 









| DDmame esses 


as FTIOE6 = Sees a EJFCB Relative track address i of the JFCB. During 
allocation, this field contains the TTR of the SIOT. 


Status indicator during allocation only and set to zeros at 
the end of allocation. This field indicates whether the unit 


affinity, volume affinity, and suballocate TIOT entry are 
primary or secondary. 


JFCB Section: 
68 | 44 SMFJFCB1 176 binary |JFCB The JFCB, excluding JFCB extensions 


DCB/DEB Section — portions of the DCB and DEB, including: 





Data set organization being used 


ras [Fe surDoaRe Tir DCBRECFM 
/247| F7 | SMFDCBMF| 2 | DCBMACRF Type of I/O macro instruction and options 


SMF DCBFL binary DCBOFLGS indicator used by the OPEN routine such as the type of the 
last |/O operation, and the return from the user's exit. 


[250 | FA] swroceor| 1 | binary [DCBOFTCD 
asi | ra swrianve| 1 [biny | 


Pa | — wil mall 


ape — Wu — 
ee _ mul _ 








Option codes used by access-method interfaces 


Data set and device status indicator. This field indicates 


whether a data set is modified, new or old, and shows the 
status of DASD. 


Indicator showing both the method of I/O processing and 
the disposition that is to be performed when an end-of- 
volume (EOV) condition occurs. 










Volume sequence number. For direct access, the sequence 
number is relative to the first volume of the data set. For 
tape, the sequence number is relative to the first volume 
processed. This field is valid only for sequential data sets. 





(Continued) 
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Tome [Name [uavath [Forme] Soweto 


For each DCB/DEB tape extension, there is a 12-byte entry with the following format: 





SMFDCBBL i DCBBLKCT Block count for each volume 


4 | swrossno | 6 [ecoiG| ucascc | Dataset ral number 
raf [ewrvanve [2 [piney [Reed 


The following 12 bytes apply to the DCB/DEB DASD extension: 
SMF14NTU DCBFDAD 









Relative track and concatenation number (TTRN) of the 
last record processed for a physical sequential! or partitioned 
data set. N is always zero except for BPAM-concatenated 
data sets. If the last operation was a read (DCBOFLGS 

bit 0 is off) the TTR is: (1) zero, (2) the start of a BPAM 
member if there are two or more IOBs, or (3) the last write 
of the data set if there is one |OB. This is true because the 
access method maintains DCBFDAD while reading only if 
RECFM=FS, RECFM=FBS, or only one [OB (BUFNO, 
NCP) is used. 


+a [| SMF14NTR | 4 | binary | TCTTKRLD Number of tracks released by the DADSM routine 


re_[ [| Swrraven | 1 [inary | TCTEXALD | Number of extents relma by the DADSM routing 
ve | [smrvanve [3 [binary | —S™~dS:C<‘i eee SSOS—SSC“S*S*S*S~S 














UCB Section — a portion of the UCB (see offsets 45 and 47), including: 





SMFUCBDV UCBCHAN Device number 


= SMFSRTEV cos UCBVOLI Volume serial number 
8 |__| swrucety | 4 |eacoic| ucerve 


ey SMFSRTES 1 pees UCBSTAB DASD volume status indicator. This field indicates whether 


this DASD volume is a private, public, storage, or control 
volume. 
13] | SMFTaNEX [1 [Binary | internal (in DEBI 
pra [ | swrtanve [2 escoc] [Removed 


ie TCTDCTR EXCP count for entire step. Note that if a data set is 


opened and closed twice during a single step, the count in 
For each UCB tape extension, there is a four-byte entry with the following format: 











the second type 14 record is the sum of all EXCPs for both 
uses of the data set. (The EXCP count in the last type 14 
record for the step is equal to the corresponding entry for 
the data sat in record type 4. For more information about 
EXCP count, see Chapter 8. 










Data set sequence count 


SMFSRTEQ| 2 | binary | UCBFSEQ 





DEBNMTRK for Number of tracks allocated on the device 
all extents 
ISAM Extension Section (DCBDSORG=IS and DCBMACRF not EXCP): 
SMF14RV6 binary Reserved 


an SMFDCBMA Yai DCBMAC Extension of I/O macro instruction field (DCBMACRF) 
for ISAM 


+3 | 3 f SMFDCBNL| 1 | binary | DCBNLEV Number of index levels 


SMFDCBR3 binary DCBRORG3 For each use of the data set, number of read or write 
accesses to an overflow record which is not first in a chain 
of such records 

+8 [| SMFDCBNR | 4 | binary | DCBNREC Number of logical records in the prime data area 


+12 SMFDCBR2 binary DCBRORG2 Number of tracks (whole or partial) remaining in the 
overflow area 


| These fields are zero for DD DUMMY and spooled data sets. (Continued) 
For virtual 1/O data sets, the device number is X’7F FF‘. When the high order bit is on in the device number 
field, a virtual device is indicated. 
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) 











ortes [ Nome [usnath] Format] Sour [Cito 


ISAM Extension Section: (Continued) 
+14 SMFDCBNO 2 binary |} DCBNOREC Number of logical records in the overflow area 


[16 | [srocant | 2 [binary [DCBRORGT | Number of cylinder overflow arees thet re full 
Caie[[swrraav7 | 1 [piney | iC 
[#19 [_[SMroeenr | 1 [binary [DEBNIEE | _Numbor of extents inthe Independent index one 
[720 | SMFDEBNP | 1 [binary [DEBNPEE | Number of extents inthe prime date area 
[+21 | | sMroeeno| 1 [binary [DEBNOEE | Number of extents in the independent overflow area 
(#22 | [SMeNcvLs [2 [binary | inernel (in DEB) | Number of cylinders inthe Independent index eee | 

ac 

i 













| +2a[ SMFNPCYL internal (in DEB) Number of cylinders in the prime data area 
| +426] | SMFNOCYL internal (in DEB) Number of cylinders in the independent overflow area 
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Record Type 15 (OF) — OUTPUT, UPDAT, INOUT, or OUTIN Data Set Activity 





Record type 15 is written for non-VSAM direct access or tape data sets that are 
defined by DD statements or dynamic allocation and opened for OUTPUT, UPDAT, 
INOUT, or OUTIN processing by problem programs. It is written by IFGO202H and 
IFGO202I when a data set, as described above, is closed or processed by EOV. Its 
length varies from 292 to 6,416 bytes, depending upon the number of volumes 

for the data set. 


This record contains information (associated with both the access method used 
and the type of data set used) from the TIOT, JFCB, DCB, DEB, and UCB data 
areas. For more information about these data areas, see Debugging Handbook. 


Note: Record type 15 is not written for data sets defined as SYSOUT data sets on 
DD statements. For accounting purposes, the SYSOUT logical record count is 
provided in record type 6. 


The format for this record is the same as the format for record type 14. 
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Record Type 16 (10) — Sort/Merge Statistics 


Record type 16 is written by IGX00017 to record information about events and 
operations of the Sort/Merge Program Product (5740-SM1). Depending on the 
option specified at initialization, a complete record, a short record, or no record is 
produced. A short record does not contain the record length statistics section. 
Note, however, that a full SMF record is produced by Sort/Merge only if the user 
requests a full SMF record and variable-length records are being sorted. Its length 
is 76 bytes plus the length of the product, data, and statistics sections. 


The format is: 


| Offsets | Name [Length] Formet | Source | Description 
a 
| 2 | smrieseG] 2 | binary [internal | Segment descriptor 


ICESIND binary SVC 83 System indicator 
Sit Meaning When Set 
0 Subsystem name follows standard header 
Reserved 
MVS/XA 
VS2 
VS1 


| 5] 5 | ICERTYPE | 4 | binary | | binary | intemal |Recordtype |Recordtype 


ICEBTIME binary SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 

ICEBDATE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


ria [-€ | icesio | 4 | eecbic| swcasio | system identification (akan from SID parametr) 
r1e [12 | iceuoenw| —s | eecoic|wnsos | obrame 
ras [1a_|_icenst | 4 | binary [MRENTAY | Timerenderrecognizediobewrd 
[a0 ve | icenos | 4 | necked |sMREDATE | Datereederrcounizediobeard SS 
Cas [ 22 | iceuie | @ | e8coic] smAUSIO | UserID (taken from common exit parameter area) 
Caz[ea | icestw | 1 | vinery [uwnster | stpmumbr 
[aaa |_iceness [3] | SC~id eee SSS 
Tae [ze | reesusio [4 [ e8cDic| imma | Subsystem entiation 


nid — se | xt 


X’O1’: Short record 
X‘02’: Full record 
[ieePnon | 4 | binary [inwmer | Oftettoprouvetsection 
ee 
Peon | exreaonl 2 [ty [wera am stemmenee 
rac | icenata | 4 | binary [interme | Ofte to common detasection 
rae [as-| esearac “3 ae nent —— peer 
Cosa | —esoaran| —2 | iey [ined | Wimbrow 
Tea[ a4 | icestat | 4 | inery |inernet | Offwt tostatiticnwetion 
7a [ae | icestate| 2 | binary |interel _| Statistica ectioniongth 
| 74/ 4A | IcesTATN| 2 | binary | internal = | Number of statistics sections = of statistics | Number of statistics sections = 


Product section: 
iCERECV EBCDIC| internal Record a 


ts ICEPRDCT| 8 | EBCDIC| internat | ——_—'| Productname: ‘5740SM1" 
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a re re eee eee eee 
Data section: 
ICERES2 2 binary internal Reserved 


+0 
(92 [| tcestenm |e | eacoic internat | Steonamesblank no eprame 
To [| teencos | 4 | winery internat | Number ofrecorde sorted 
| 414 | | ICEBYTEs | Number of bytes sorted (sum of record lengths) 
Tre [ | cecrur 


| 422 | | iceLen | 2 | binary [internal Specified record length 
+24 az ICEIBLK | 2) | binary | internal Maximum input blocksize! 


ICEOBLK | 2) | binary — internal Output blocksize! 2 


+e | 
+28 ICEKEYLN binary internal Total control field length (number of bytes actually 
compared by Sort) 


_+30 | | icewsrk | 4 | binary interns | Number of work data set tracks used 
Bit 


+34 ICEFLBYT binary internal Meaning When Set 

0 Reserved 

1-23 Q0=Fixed-length records 
01~Variable-langth records 
10=Variable-length spanned records 
00=Blockset 
01=Peerage 
10=Vale 
11=Conventional and merge 

5 “1‘B if Sort dynamically or explicitly invoked 

6-7 Reserved 


Taas_| | eenovnal 1 | tinary [inmrnat | Nurntr of alocamdvorkaewe 
a6 | [iceness [2 Reserved 


Statistics section: 
ICECTRO1 binary internal Records in interval 1 


+0 
(+4 |_| icecrnoz | + | winery [internat | Recordrin neal? 
[ve | | tcecrnos [4 | binary [intemal | Recordsininteral'3 SCS 
Pz _[ | scectnos | 4 | binary [intemat _| Records ininter@ 
(#20 [ | icectaos | 4 | binary [interme | Records in interval 6 
| +24 | | icectro7| 4 | binary internal Records in interval 7 
[428 | | icectros | 4 binary Records in interval 8 
[saa | | seeermoa | 4 | binary [interna | Records in intaval@ 
Tas || acces | 4 | binary [internat | Records in intarval 10 
| +40 | | icectRi1 | 4 | binary — internal Records in interval 11 
Tas || _icectasa | 4 | binary [intemal 
p+s2 | | icecrris | 4 | binary | internal 
+56 | | icectris | 4 | binary | internat 


TICEIBLK and ICEOBLK are set to zero if the corresponding data set (input or output, respectively) is not present. 




















Records in interval 12 
Records in interval 13 
Records in interval 14 
Records in interval 15 


Records in interval 16 


2invalid for VSAM data sets and set to zero. 


Sit ICEFLBYT bits 1-2 are binary zeroes (indicating a fixed-length record), the short form of the SMF record is produced, 
even if the user has specified the full SMF record. In addition, |CERSUB is initialized to X‘0001’ to indicate that the short form 
has been produced. 
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Record Type 17 (11) — Scratch Data Set Status 


Record type 17 is written by IGGO290D when a non-temporary data set or a tem- 
porary data set is scratched. This record contains the data set name, number of 
volumes, and volume serial numbers. Its length varies from 100 to 2,140 bytes, 
depending upon the number of volumes for the data set. 


Note: You use the REC parameter in the SMFPRMxx parmlib member to specify 
whether information for record type 17 is to be collected. REC(ALL) 
specifies that record type 17 is to be written for both temporary and non- 
temporary data sets. REC(PERM) specifies that record type 17 is to be 
written only for non-temporary data sets. 


The format is: 
























SMF17FLG binary |SVC 83 System indicator 
7 VS1 
18 | 12 | smFi7uen | 8 | EBCDIC| JMRJOB 
| 44 | 2C | SMF170SN | 44 | EBCDIC| user's parameter list | Data sot name 


[Orteets [Name | Lovath] Formet| Source Description 
_o | o | smet7ien| 2 [binary |internai ___[ Record length 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
| 6 | 5 | SMF17RTY | 1 [binary | internal = Record type 
SMF 17TME binary joxernel 83 Time, in hundredths of a second, record was moved to SMF 
buffer 
SMF17DTE packed | SVC 83 ‘Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the System Wenttication taken fram SID peramate 
SMF 17RST binary | JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job ! 
SMF17RSD packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOY YDDDF where F is the sign 1 
SMF17UiID JMRUSEID ‘User identification (taken from common exit parameter 
area) 
Tae [68 | sMri7Avi| 3 [binry | ——S—i«d Reed OOS 
For each volume, there is a eight-byte entry with the following format: 


| 2 | 2 | SMFI7SEG | 2 [binary | internal [Segment descriptor 
6 VS2 
14 | € | SMF17SID | 4 | EBCDIC| ISMCASID —_—s=| System —_«—— (taken from SID | System identification (taken fromSID parameter) 
[42 | 2a | swri7RiN | 2 [binary | ————~*diReserve 
SMF17RV2 i Reserved 


SMF17FVL EBCDIC | user’s parameter list | Volume seria} number 


1The job name and the time and date that the reader recognized the JOB 
card for this job constitute the job log identification. 
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Record Type 18 (12) — Rename Data Set Status 


Record type 18 is written by IGGO3001 when a non-VSAM data set that is defined 


by a DD statement (either explicitly or implicitly) is renamed. (When a DD 


statement defines a volume, all the data sets on that volume are implicitly defined.) 
This record contains the old data set name, new data set name, number of volumes, 


and volume serial numbers. Its length varies from 144 to 2,184 bytes, depending 
upon the number of volumes for the data set. 

































| Offsets | Name [Length] Format | Source Description 
eaEY SMFI8LEN | 2 | binary [internal |_ Record length 
Tsmrreses [2 | binary [interna | Segment Descriptor 
0-4 Reserved 
5 MVS/XA 
: VS2 
6 binary |SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 
SMF 18DTE packed |SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF where F is the a er 
14 | E | SMF18SID | | System identification (taken from SID parameter) =| eater (taken from SID parameter) 
SMF18RSD packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOY YDDDF where F is the sign 2 
SMF18UID JMRUSEID User identification (taken from common exit parameter 
area) 

a 
naz[es | sMFiaRVi | 3 [binry | | “Rewved SOS 
135 | 87 | SMF18NVL | 1 __ | binary [user's parameter list || Number of volumes 
For each voiume, there is an eight-byte entry with the following format: 


SMF18FLG binary |SVC 83 System indicator 
VS1 
a eo 
eee SMF180DS | 44 | EBCDIC | user's parameter list | Old data set name 
SMF18RV2 


The format is: 
Bit Meaning When Set 
SMF18RST binary JMRENTRY Time, in hundredths of a second, reader recognized the JOB 
card for this job 2 
fas [56 | sMFtanos | 44 | EBCDIC | user's parameter lit | New date setname 
SMF 18FVL 







Reserved 





EBCDIC | user’s parameter list Volume serial number 





1The job name and the time and date that the reader recognized the JOB 
card for this job constitute the job log identification. 
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Record Type 19 (13) — Direct Access Volume 


Record type 19 is written by IGCO107H (1) for each direct access device that is 
online at IPL, (2) for each direct access device that is online when a HALT EOD 
or SWITCH SMF command is processed, and (3) when a volume that is defined 
by a DD statement is demounted. Its length is 68 bytes. 


This record contains the volume serial number, VTOC address, owner 
identification, unit type, number of unused alternate tracks, number of unallocated 
cylinders and tracks, number of cylinders and tracks in the largest free extent, and 
number of unallocated extents. It also contains the device number and module 
identification for devices having movable address plugs. 


Notes: 

1. Record type 19 is not produced for DOS volumes used under the operating 
system. 

2. In order to determine the latest status of a shared file, the CPU clocks must be 
synchronized. 
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The format is: 


|_Offsers | Name [Lengen [Format | Source | Dmerintiors 


poe SMFIOLEN | 2 [binary | internal |_ Record length 
2 | smMFigseG | 2 [binary [internal |_ Segment descriptor 


SMF1ISFLG SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
MVS/XA 
VS2 
VS1 


| 5 | 5 | smrigrty | 1 | binary | interns | Recordtyvpe 


SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 
A SMF1ISDTE SVC 83 Date record was moved to SMF buffer, in the form 
0O0Y YOODF where F is the sign 


ec 
rie [12 | Swrtonvs | 2 | binary 


14 SMF 19VOLU volume ——___— rere serial number 
(VOLSERNO) 

1A volume labei2 Owner identification of direct access volume 
(VOLOWNER) 


| 36 | 24 | smFi90ev| 4 | binery | UcBTYP | Unittvpe 


SMF19VTC volume label? VTOC address 
(VOLVTOC) 


SMF 19VT!1 DS4VTOCI VTOC indicator 
(in OSCB4) Bit Meaning When Set 
OS400SBT Format 5 DSCBs missing or erroneous 
Reserved 
OS40STKP VTOC does not begin on record 1 
OS4DICVT Accurate Format § and 6 OSCBs; bit 0 set to 0 
DS4DIRF Possible VTOC or VTOC index error? 
OS40ICVT V TOC error has been fixed: bit 5 set to 0 
OS41 VTOC 7 Indexed VTOC 


Number of OSCBs, calculated as: number of OSC8s per 
track times number of tracks in VTOC 
binary | OS4DSREC Number of OSC8Os, that is, number of available OSCBs 
(in OSCB4) 
SMF 1SNAT binary | OS4NOATK Number of unused aiternate tracks 
(in OSCB4) 


Ts2 | sa | SMFIOSC | 2 | binery | internal (OSCB5)_| Number of unallocated cylinders 
rsa) 36 |_| 2 _| binary | internal (OSCBS) | Number of unallocated wack 
| 56 | 38 | SMFI9LEX] 2 | binary | internal (DSCBS) — Number of cylinders in the jargest uneilocated extent 

rsa [aa |__| 2 | Binary _| ineernal (OSCBS)_| Number of tracks in the largest unallocated extent 
Teo [3c | SMFI@NUE| 2 | binary | intrnal(OSCBE) | Number of unallocated extant 
2 SS 


To ee Stee aaa 


identity of devices having moveeble address piugs. This 
The volume label for the direct access device is record 3 of cylinder O of track 0. 



















field is taken from bits 2-7 of sense byte 4 for these 
devices. (See the component descriptions of these devices 
for the meaning of sense byte 4.) 


2Bit 5 may be set for SMF record 19 even though it may not be set in Format 4 OSCB for an indexed VTOC when active 
VTOC Racording Facility (VRF) data is present in the VTOC index. 
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Record Type 20 (14) — Job Initiation 


Record type 20 is written by IEFSMFIE at job initiation (including TSO logon). 
This record contains the job log identification, user identification programmer’s 
name, number of accounting fields on the JOB statement, accounting fields, and 


RACF-related information. Its length is 65 bytes plus the length of the JOB 
statement accounting fields and the relocatable RACF section. 


The format is: 


| o | o | smrzouen| 2 [binary [interne | Recordiength 
| 2 | 2 | smr2oseG| 2 [binary [internal | Segment descriptor 


SMF 20FLG SVC 83 System indicator 
Bie Meaning Whan Set 
0-4 Reserved 
5 MVS/XA 
° VS2 
VS1 


Ts [5 | swraonry[ + [enery [inmrat ‘| Records 


SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 
SMF 20DTE SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDODEF where F is the sign 


| SMCASID System identification (taken from SID parameter) 
Hee awesnien | Da [esc IMRJO8 


1A JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job? 
packed |JMREDATE Oate reader recognized the JOB card for this job, in the 
form OOY YODOF where F is the sign? 


|) 4) 22 | swezquin |) 8 | eacaic| JMRUSEID User identification (taken from common exit parameter 
area) 


“421 2A | sMF20RLO| 2 [binary |IEFSMFIE | Offset to relocatable area from beginning of record. 
Pee Tre | serron| 9 | eacor[acrrnaiat ech 
| 1 | binary ACTJNFLD (in JCT) | Number of accounting fleids 


Sie JOB statement Accounting fields. Esch entry for an accounting field 
contains the length of the field (one byte, binary) foilowed 
by the fleid (EB8CDIC). A zero indicates an omittad fieid. 

Relocete Section 
SMF2Z0RLS size of relocate section including this field. 
+2 RACF Group ID. 
lf RACE is not active, this field is set to zero. 
+10 SMF 20RUD ACEEUSR! RACF User ID. 
lf RACF is not active, this field is sat to zero. 


+18 SMF 20TID ACEETRMP If RACF is not active, this field is set to zero. Also, if 
RACEF is active and the user is not e terminal user then 
this field is set to zero. 


'The job name end the time and date that the reader recognized the 
JO8 card for this job constitute the job log identification. 
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Record Type 21 (15) — Error Statistics by Volume 





Record type 21 is written by IGCO009A when a user data set on magnetic tape is 
demounted. This record contains statistics for the entire volume during the period 
of time that the volume is mounted regardless of the number of data sets on the 
volume being accessed and regardless of the number of CLOSE macro instructions 
issued. Its length is 62 bytes. 


This record contains the volume serial number, device number, unit type, and 
tape density. It also contains the number of temporary and permanent read and 
write errors, START Subchannel (SSCH) instructions, noise blocks, erase gaps, and 
cleaner actions. 


Notes: 

1. The IFHSTATR utility program formats and prints the error-statistics-by-volume 
(ESV) information in this record. For a detailed description of this utility 
program, see OS/VS2 Utilities. 

2. If a maximum count is reached, it is no longer incremented. A counter at its 
maximum value indicates at least that number since no record is written when the 
counter is full. 

3. Arecord type 21 is written, in addition to demount tine, any time EREP is run or 
when EQD is issued. Therefore, more than one type 21 record may be written for 
each tape that was mounted. The total count will be accurate because the counters 
are cleared when a type 21 record is written. 


The format is: 



















- SMF21FLG 1 SVC 83 


Description 





Record Lenath 


Segment descriptor 


System indicator 





Bit Meaning When Set 
0-4 Reserved 

MVS/KA 

VS2 

VS1 


Record type 


Time, in hundredths of a second, record was moved to SMF 


SMF21TME binary SVC 83 
buffer 
A SMF21DTE packed SVC 83 Data record was moved to SMF buffer, in the form 
OO0OY YDDDF where F is the sign 
SMF21 SID EBCDIC | SMCASID System identification (taken from SID parameter) 


18 12 SMF21LGH binary internal Length of rest of record including this field. (This field is 
always 44.) 


2 Device number or device address 

1 Number of temporary read errors (Non-buffered log) 

33 Number of temporary write errors (Non-buffered log) 

sa [aa| swravsio | 2 | binwy | UCeSIO | numberof sScH invucions 
se [at | swraien | + | piney | UcaPR | Number of manent rea ero 
raz [2s | smeziew | 1 | winey | ucarw | Number of permanent write rors 


(Continued) 
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1 










a 


DCBDEN Tape density — 2400 and 3400 series magnetic tape units 


Ea 
Le 
| - 7 / 


ye 7 
46 [26 | smF2i0FL 


SMF210FL 


























Bits Meaning When Set 
Code 7-Track 9-Track 
DCBMTDNO 6,7 0 200 BPI N/A 
DCBMTDN1 113657 1 556 BPI N/A 
DCBMTDN2 0,6,7 2 800 BPI 800 BPI 
DCBMTON3 0,1,6,7 3 N/A 1600 BPI 
DCBMTDN4 0,1,3,6,7 4 N/A 6250 BPI 











Block size. This field is zero if DCBRECFM indicates 
variable or unblocked records, if you are doing your own 
EXCP processing, or if module |GCOOO9A was entered 

from EREP, VARY, or Allocation. 


DOCBBLKSI 


binary DCBCOFLG DCBOFLG 


47 2F SMF21TUS packed UCBCXTUS Tape unit serial 
UCBCTD 


}s0 [32 | SMF21TRF | 2 | binary | UCBCXRD Temporary read forward errors 
)52 | 34 SMF21TRB fe binary | UCBCXRDB Temporary read backward errors 


1 


; 
SMF21BR 3 binary | UCBCXMBR Bytes read * 4096 
3 UCBCXMBW Bytes written * 4096 


binary 





SMF21BW 
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Record Type 22 (16) — Configuration 


Record type 22 is written: 
e by ICB2MSG and IEEMB823 after every IPL of the system, 


e by IEECLEAN when aCONFIG CPU or CONFIG CHP operator command is 
processed, 


e by IEEMPVST or IEEVSTGL when a CONFIG STOR operator command is 
processed, 


e@ by IGCOO012F when a VARY ONLINE;S or VARY OFFLINE;S operator com- 
mand is processed 


This record describes the processor, channel path, storage, or mass storage device 
configuration in effect after the IPL or change. The storage section contains 3 ]-bit 
real storage addresses. Record type 22 also describes the MSS units online at IPL. 
The length of this record is 22 bytes plus the length of the sections in the record. 


Notes: 

1. During system initialization, the Mass Storage Control (MSC) creates a 
configuration record (called Message 92) and puts it in a message buffer. After 
SMF is initialized, ICB2MSG creates the “MSS IPL Configuration section” of 
record type 22 from the Message 92 in the MSC buffer. 

2. By using the VARY ONLINE;S and VARY OFFLINE,S commands, the 
operator can modify the configuration. (The format of these commands is 
described in Operaror’s Library: IBM 3850 Mass Storage System (MSS) Under 
OS/VS.) In a record type 22, a “WARY ONLINE;,S section” or a “WARY 
OFFLINE,S section” is written for each unit varied by these commands. 


The format is: 


es 
Te [0 | swraoten | 2 [binary [invernai | Recording 
ra [2 | swraaseG [2 [binary [internat | Seument deserpvor 


Systam indicator 


Bie Meaning When Set 
0-4 Reserved 

5 MVS/XA 

6 VS2 

7 VS1 


es swrcanre [Tiny [inert Renee 


SME2Z2TM SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 
10 SMFZ2DTE packed (SVC 83 Date record was moved to SMF buffer, in the form 
0OY YODOF where F is the sign 


14] E SMF22S!10 | 4 | EBCDIC| [SMCASID System identification (taken from SID parameter) 




























































18 12 SMFZ2IND Record creator indicator 
Vaiue Meaning 
IEEMB823 1 IPL 
IEEVCPR/ 2 VARY ONLINE 
IEEVSTGL 
ebonse 4 MSS at IPL 
MSG 5 VARY ONLINE,S 
IGCO012F 6 VARY OFFLINE,S 
IGC0012F 7 VARY CHANNEL PATH ONLINE OR OFFLINE 


re [ie [sweet [2 [ener [inwme_[ Noni meer ton 


(Continued) 
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C Totes [Nene [ovat] Former | Souee[anrptom 


CPU Section: 
SMF22CFG 1 binary CPU Flags 
Bit Meaning When Set 
0 Vector Facility indicator (VF online) 
1-7 Reserved 


pet fo SMF22PID IEEVCPR | CPU section identification. (This field is always 1.) 
P42 || SMF22CPN IEEVCPR CPU model number (taken from CONFIG CPU command 


+5 SMF22CPA 1 binary JIEECLEAN CPU identifier (taken from CONFIG CPU command or 
default in PSACPUPA) 
Channel Path Saction: 
SMF22RV7 binary Reserved 


= SMF22UID 7 [oe [ine Channel Path section identification. {This field is always 7.) 


SMF 22PAR EBCDIC] ICHICPT Array of 256 entries to map each unique CHP 

SMF 22PFG If 1=CHP, CHP is valid for this installation. If 0, 
SMF 22POW=0 and SMF 22PON=0 

SMF22POW If 1=CHP, CHP is owned by this system, and SMF22PFG=1; 
if 0, SMF22PON=0 

SMF22PON If 1=CHP, CHP is ONLINE, SMF22PFG=1, and 
SMF22POW=1 


Reconfigured Channel Path Section: 
SMF22RV8 binary Reserved 
SMF22RID binary internal Reconfigured Channel Path section identification. (This 
field is always 8.) 


) +3 | | SMF22CHI cso mera Array of channel path identifiers 


Storage Section: 
SMF22MFL 1 EBCDIC] |EEMB823 Storage flags 
Bit Meaning When Set. 
0 Real storage frames are interleaved 
1-7 Reserved 


Pat || SMF22TID 1 | binary IEEVSTGL | Storage section identification. (This field is always 3.) _| section identification. (This field is always 3.) 


+2 SMF22PGL binary IEEVSTGL Address of lowest frame in real contiguous storage (taken 
from CONFIG STOR command 

+§ SMF 22NPG binary IEEVSTGL Number of frames in real contiguous storage (taken from 
CONFIG STOR command) 


Extended Storage Section: (one contiguous block of online extended storage) : 

















Reserved 


Papo SMF22X1D Tone binary | Extended storage identification. (This field is always 9.) 


SMF22X AD binary fovea) Beginning extended storage frame (E-frame) address 
in this contiguous block 
Note: Extended storage is always addressed in frames 


SMF 22X NP binary internal Number of 4K extended storage frames in this 
contiguous block 
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_Offeers | Name [Length] Format | source | Description 


MSS IPL ee Section: 
SMF22RV4 binary Reserved 


SMF 22I1D binary | |ICB2MSG MSS IPL configuration section identification. (This field 
is always 4.) 


The following 40 bytes contain the bit pattern of MSS units online at IPL: 


+2 2 SMF2210N 1 binary (See Note 1) Data recording devices (DRDs) of MSF(0) 
Bit SSID 
0 200 
1 201 
2 202 
3 203 
4 204 
5 205 
6 206 
7 207 


+3 3 1 binary Data recording devices (DRDs) or MSF(1) 
Bit SS/D 
0 210 
211 
212 
213 
214 
215 
216 
217 


a 


+6 6 binary Staging Adapters 
j SSID 
800 
810 


+8 binary i i 
Device recording controls (DRCs) of MSF (1) 
4 410 
5 411 
6 412 
413 
binary Staging spindles in staging data groups (SDGs) 
SDG_ Bits SS/Ds 
0 Q-7 000-007 
1 0-7 008-00F 
2 0-7 010-017 
3 - 018-01F 
27 OE8-OEF 
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J 

















[_oftests | Name [Length] Format | Source 


MSs Pl Configuration Section: | MSS [PL Confiauration Section; (Contr 
| MSS [PL Confiauration Section; (Contr Reserved 

















binary MSF indicator 
Bit Meaning When Set 
0 MSF (0) with SSID of 101 
1 MSF (0) with SSID of 102 
2 MSF (1) with SSID of 111 
3 MSF(1) with SSID of 112 
Reserved 


VARY ON eee ewcmmve | 1 Section: 
SM eee ewcmmve | 1 ‘inary Reserved 
binary — VARY ONLINESS section identification. (This field is 
alweys 5.) 


+3 3 binary | 1GCOQ0Q12F Subsystem identification of device (taken from VARY 
ONLINE,S commana) 
ol 1 | SMES ani 
SMF22RV6 binary Reserved 
+1 binary iGC0012F VARY OFFLINE;S section identification. (This field is 
always 6.) 


ea |= | arse | Ten Remned OSSSOSCSCSCS~S~S~S 


+3 binary —— 2F ee identification of device (taken from VARY 
OFFLINE,S command) 
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Record Type 23 (17) — SMF Status Record 


Record type 23 is written by IEEMB842 at the interval specified by the STATUS 
keyword. It records SMF statistics collected during the reporting interval. Its 
length is 82 bytes. 


The format is: 


[orto [Name [Lerath [Format | Sowee [SSC rite 
a 

rswr2aseG [2 [binary internat | Segment deserintor 
seo a oe 
[ss | swrzanty | 1 | binary [internat [Record ype 


SMF23TME binary SVC 83 Time, in hundredths of a second, when the record was 
moved to SMF buffar 

SMF23DTE packed | SVC 83 Date record was moved to SMF buffar, in the form 
OOYY DDDF, where F is the sign 


System identification | System identification (takan from the SID parameter) —_——| from the SID | System identification (takan from the SID parameter) —_——| 


a 


binary internal Offset to product section from start of record, including 
tha ROW 


Number of idbeasaa sections 


RDW 


eee ee ee — ee 
"sMe2as0n | 2 [binary [internal | Number of aystemsections SSCS 


binary internal Offset to SMF statistics section from start of record, 
including tha ROW 


SMF23RLN | 2 | binary | internal | __ Length of SMF statistics section 
pe ee a ee ee 


Product Section: 
binary internal Sub type identification — ‘OQ’ 


SMF23TID 


a] swezaenn [8 [score ier | —Prower name — SF 
1 Section: 


SMF23INT ce Vinal SMCASSTS Length of measurement interval 


I SMF23RLS | 4 | EBCDIC CVTRELNO Opareting system release level 


SMF Statistics Section: 
SMF23BEW SMCABFWT Number of buffers written 


sa [ [ivr aaaea: [4 sine [sonar — Maximum number of buffers used at one time, 
48 | | SMF23SUS | 4 | binary | SMCANMSU Number of times suspended because no buffers are available 


2] _[ smrzancw | [inary [sMcancw | Numberfrecordnwriten 
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Record Type 24 (18) — JES2 Spool Offload 


Record type 24 is written by HASPNET or HASPRDR whenever a job or SYSOUT 
data set is transmitted to or received from an offload data set. JES2 writes one 
type 24 record for each pre-execution job that is transmitted to an offload data set 
or received back to spool. Because one type 24 record is written for each SYSOUT 
data set header that is transmitted or received, multiple type 24 records can be 
expected for each post-execution job. 


This record identifies the name, time and date of each job that has been transmitted 
or received. It also includes specific information about jobs in a record subtype. For 
jobs not yet executed, it reports job-related information such as job class and 
system affinity in the job selection criteria section. For jobs that have already exe- 
cuted, it reports information about SYSOUT data sets such as output group id and 
forms name in the SYSOUT selection criteria section. Whenever record type 24 
contains the job selection criteria section, the length is 206 bytes; when it contains 
the SYSOUT selection criteria section, the length is 227 bytes. Record type 24 
never contains both sections. 


Use IFASMER to map the JES2 type 24 record. For more information see “Using 
the IFASMFR Macro to Address SMF Record Fields” in Chapter 4. 


The format is: 


[ove [Ware [Lona] Format [Source SCDmeripvon 


SvezAs F24FLG binary SVC 83 System indicator 
j Meaning When Set 
Subsystem name follows standard header 
Reserved 
MVS/XA 
VS2 
Reserved 


SMF24RTY | 1) | binary | binary J internal = Record type 


SMF24TME binary verre! 83 Time, in hundredths of a second, record was moved to 
SMF buffer 

SMF24DTE packed SVC 83 Date record was moved to SMF buffer, in the form 
0OYYDDDF where F is the sign 


See SMF24SID 4 | EBCDIC | SMCASID System identification (taken from SID parameter) 
SMF24SSI| p 2 | EBCDIC J internal Subsystem identification 


SMF24SUB EBCDIC vere! Record subtype 
youe Meaning 
Job transmitted 
, Job received 
3 SYSOUT transmitted 
4 SYSOUT received 
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[ovtws [name [tonom] Former [Sows [~~S~SCerpton 
| 44 | 2c - SMF240SP | 4 =| binary | internal Offset to job or SYSOUT selection criteria section 

| 48 | 30 _ SMF 24LSP } 2 | binary | internal Job or SYSOUT selection criteria section length 

| 50 | 32 | SMF 24NSP 2 | binary | internal Number of job or SYSOUT selection criteria sections 


Product Section: 
SMF24PVR EBCDIC internal Record version number 


Job completed with skipped data sets 


General Section for Spool Offload Devices: 
SMF24GLN 2 binary ao Length of general section 
0 
1 
2 Uncompleted job offloaded 
oS 


i SMF24BCF ial binary internal Buffer continuation flags 
SMF 24EOJ binary internal 
Job cancelled by operator 
Reserved 





Meaning When Set 


First SMF buffer for job 
Continuation of SMF buffer 
Last SMF buffer for job 
Reserved 


End of job flags 


Bit Meaning When Set 
Completed job offloaded 





| SMF24JBN | EBCDIC| JCTNAME 
pala meet st mae 
| 432) +20 | SMF24DSN | | EBCDIC, | XDCTDSN 


SMF24CNT rain | +P Be Ph Number of records transmitted or received 
su bane, 


'The source of this field varies with the subtype value set in SMF24SUB. If the value equals 1, the source is JTWCOUNT; if the value 
equals 2, the source is ROWCNTRR; if the value equals 3, the source is STWCOUNT; if the value equals 4, the source is 
SRWCOUNT. 


6-58 System Management Facilities (SMF) 


J 








General Section (continued): 

[am [ae [ee 
OOY YDDDF where F is the sign 

[vas [oe swrasone [6 | eecoic| xocToaTe | Nodeotorin 


| +96 | +60 | SMF24TRD | 4 | binary | JCTNONDE Time on reader where F is the sign 
| +100] +64 SMF24DRD | 4 | binary — JCTRDTON Date on reader, in the form OOY YDDF where F is the sign 


Job Selaction Criteria Section: 
SMF24LN binary internal Length of job section 


SMF24JFG binary internal Job flags 
j Meaning When Set 
Held job 
Affinity = any 
Reserved 


+3 SMF24JCL EBCDIC| varies with Job class 
subtype2 


| SMF24JND EBCDIC] JCTNXNDE | Nodename = es sss—‘—sSSCizr | Nodename = es sss—‘—sSSCizr 
ae SMF24J AF — EBCDIC| internal = Affinity system identification 


| SYSOUT Selection Criteria Section: 
SMF24LN2 binary internal Length of SYSOUT section 


SMF24SFG binary internal SYSOUT flags 
j Meaning When Set 
Held SYSOUT 
( Bursted SYSOUT 
Held job 
Incomplete data set 
Multi-destination data set 
Reserved 


43 cane SMF24SCL pt EBCDIC| NDHGCLAS SYSOUT class 

SMF24FCB 4 EBCDIC| NDHGFCB Forms control buffer (FCB) 
SMF24F LS Za EBCDIC| NDHAFLSH Flash cartridge name 
SMF24PRM | 8 EBCDIC| NDHGPMDE Print data set (PR) mode 
SMF24UCS / 4 | EBCDIC| NDHGUCS Universal character set (UCS) 
| +60] +3C) SMF24PRY PDBPRIO Output selection priority 


2 














The source of this field varies with the subtype value set in SMF24SUB. If the value equals 1, the source is JT(WCOUNT: if the value 
equals 2, the source is ROWCNTRR. 
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Record Type 25 (19) — JES3 Device Allocation 


Record type 25 is written by IATPURG for each job that completed JES3 
converter/interpreter (C/I) processing. One type 25 record is written for all device 
allocations required for the job, whether or not the job contains DD statements. 
Also, for any job that uses a private catalogue, IATPURG writes a separate type 
25 record for each group of JES3 device allocations used by that job, and 
IATMDBK writes a separate type 25 record for each main device scheduling 
(MDS) dynamic allocation request. 


This record contains allocation-related information such as the number of tape 
and disk volumes fetched and mounted, the time and date of the first mount 
message, and the time and date of JES3 device verification. 


Use IFASMER to generate the JES3 record type 25 macro mappiing. For more 
information, see “Using the IFASMFR Macro to Address SMF Record Fields” in 
Chapter 4. 


The format is: 


[otis [Wome [tava Forme | Sowee [meron 
| o | O | SMF25LEN| 2 | binary |internal | Record length 
2 | 2 | smezsseG | 2 | binery [interne|__{_Segment deveriptor 


SMF25FLG binary | SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
MVS/XA 
VS2 
Reserved 


Ts [5 | swrzsnrv| 1 | binary [imerral ‘| Reerdtyee OSSOSCSCS—~—S 


SMF25TME binary SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 

SMF25DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF where F is the sign 


| — | SMF25siID | 4 | EBCDIC]} SMCASID System identification (taken from S!1D parameter) 


SMF25RST binary JMRENTRY (Set Time, in hundredths of a second, reader recognized the 
by IATISJB) JOB card for this job2 
1E packed | JMREDATE (Set Date reader recognized the JOB card for this job, in the 
by |ATISJB) form OOYYDDDF where F is the sign? 
4) 2 SMF25U IF fo EBCDIC| JMRUSEID User identification (taken from common exit parameter 
area) 


Descriptor Section: 
42 2A SMF25IND binary | JST25FG1 Allocation indicators 
] Meaning When Set 
If O, allocation by user’s DD statements. 
If 1, dynamic allocation. 
If 0, non-catalog allocation by JES3. 
If 1, catalog allocation by JES3. 
If 0, manual allocation by operator. 
lf 1, automatic allocation by JES3. (See the MDS 
parameter SETPARAM in OS/VS2 System 
Programming Library: JES3 System 
Programmer's Guide for more information.) 
Reserved 


1The job name and the time and date that the reader recognized the (Continued) 
JOB card for this job constitute the job log identification. 
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C [ortwe [Nemo [tenath] Format Sowes | S~S~S~C arnt 


Descriptor Section (Continued) 


SMF25NTF i JST25NTF Number of |AT5110 GET messages for tape 
volumes issued for the job. 


binary JST25NDF Number of 1AT5110 GET messages for disk 
volumes issued for the job. 


SMF25FST JST25FST (Set Time, in hundredths of a second, fetch processing ended. 
by IATMDFE) That is, the time that the first phase of MDS ended. 
(During this phase, messages are issued to inform the 
Operator of the volumes required for the job to execute.) 
packed | JST25FSD (Set Date fetch processing ended, in the form OOY YDDDF 
by I|ATMDFE) where F is the sign 
“ae F25SST binary | JST25SST (Set If manual allocation, time *START SETUP operator 
by IATMDDR) command issued. If automatic allocation, this field 
contains zeros. 
packed | JST25SSD (Set If manual allocation, date "START SETUP operator 
by IATMDDR) command issued. If automatic allocation, this field 
contains zeros. 


| 68 | 44 | SMF25NTM| 4 | binary | JST25NTM Number of tape volumes mounted by MDS. 
| 72 | 48 SMF25NDM | 4 | binary — JST25NDM Number of disk volumes mounted by MDS. 


76 4c SMFE25MST binary JST25MST (Set Time, in hundredths of a second, when all JES3 volume 
by |ATMDSL) mount messages have been issued. |f no mounts were 
required, this field equals the time of JES3 allocation. 
packed | JST25MSD (Set Date when all JES3 volume mount messages have been 
by |ATMDSL) issued, in the form OOYYDDDF where F is the sign. If 
no mounts were required, this fleid equals the date of 
JES3 allocation. 


nd ) SMFZEVVT binary JST25VVT (Set Time, in hundredths of a second, of JES3 device 
by IATMDVE) verification 
— packed | JST25VVD (Set Date of JES3 device verification, in the form 
by IATMDVE) OOYYDDDF where F is the sign 
5C SMF25NMV binary | JST25NMV Number of Mass Storage Volume requests allocated 
by MDS for the job. 
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Record Type 26 (1A) — JES2 Job Purge ) 


Record type 26 is written by HASPMISC at job purge after all SYSOUT for the job 
is processed. This record identifies the job by job log identification, JES2-assigned 
job number and programmer’s name. 


Record type 26 also contains operating information such as, message class, job class, 
JES2 job selection priority, JES2 logical input device name, output lines, output 
punched cards, print/punch route codes, and start and stop times for the reader, 
converter, execution processor, and output processor. Its length is 236 bytes plus 80 


bytes for the network section, 22 bytes for the routing section and 18 bytes for the 
print section. 


Use IFASMFR to generate the JES2 record type 26 macro mapping. For more 


information, see ‘Using the IFASMFR Macro to Address SMF Record Fields” in 
Chapter 4. 


The format is: 


Toviwss [Nome [ tewath] Format | Sowes [Deweipion 
fo Yo | Swrzscen| 2 [vinery [inves | Recordienath 
-2__2_|_SMFZ6S56 | 2 _| binery_{ internel_[_Seament deseriptoy 


4 SMF26FLG System indicator 


Bit Meaning When Set 
0-4 Reserved 

5 MVS/XA 

6 VS2 

7 Reserved 


binary Time, in hundredths of a second, record was moved to 
SMF buffer 
SMF26DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF where F is the sign 


<a t EBCDIC | SMCASID System ieenntieenen (taken from SID parameter) 


SMF26RST binary | JCTRDRON Time, in hundredths of a second, reader recognized the 
JOB card for this job? 
packed | JCTRDTON Date reader recognized the JOB card for this job, in the 
form OOY YDDDF where F is the sign? 
Cara SMF26UIF 8 EBCDIC| JCTUSEID User identification (taken from common exit parameter 
area) 


cae [aa | smrzensv[ «|e [| Rowe 


ae = 
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Bit Meaning When Set 

0 Descriptor section present 
1 Events section present 
2 Acutals section present 
3 Reserved 

4 Routing section present 
5 

6 

7 











Print section present 
JES2 Spool use section 
-15 Reserved 





C 


“I OOAWN — O 










binary Sere JOBFL Job information indicator 
Meaning When Set 
Background batch job 
Foreground TSO user 
System task 
No journal option 
No output option 
TYPRUN=SCAN was specified 
TYPRUN#=COPY was specified 
RESTART = Y was specified 
JES2-assigned job number and xxx is: 
JEBCDIC|JCTPNAME _| Programmer's name (taken from JOB card) 
oe eS ee JCTPRIO JES2 job selection priority when the job was selected 
A SMF26DEV | 8 | EBCDIC | JCTINDEV JES2 logical input device name 
/120|78 | SMF26EPU | 4 [binary |JCTESTPU Estimated output punched cards? 


Lorton _[__news_| teres rormes |_seems |___Doeroon 
tie Section: 
SMF26LN1 binary ‘eterna Length of descriptor section, including this field 
rete SMF26RV1| 2 | binary — Reserved 
SMF26INF JCTJBOPT Job information indicator 
Bit Meaning When Set 
0 /* PRIORITY card present or keyword 
‘PRTY =’ was specified on JOB card 
/* SETUP card(s) present 
TYPRUN=HOLD was specified 
No job log option 
Execution batching 
Job was entered on internal reader 
Job was rerun by JES2 
Job was canceled by the operator 
JEBCDIC|JCTJOBID +4 | +4 JES2-assigned job number 
Cee Job identification in the form xxxOyyyy where yyyy is the 
JOB — for normal JES2 job 
STC — for started task control job 
TSU — for TSO job 
SS | suena 20 | EBCDIC. JCTMCLAS Message class (taken from JOB card) 
}a9 |59 | smF26ecis | 1 |eBcDIC|JCTJCLAS Job class (taken from JOB card) 
}90 [54 | smF2exP! | 1 |binary |JCTIPRIO JES2 job selection priority when the job was initially read 
[sc | smrzsort [1 [biney | | (Reeves 
Gl dl 
sMF26Loc | 2 |binary | JCTROUTE 
104 | 68 SMF26ACT | 4 |eBcpDICc JCTACCTN Programmer's accounting number 
[10s [ec_| sMF26ROM| 4 [EBCDIC|JCTROOMN | _ Programmer's room number 
412 | 70 — SMF26XTM | 4 | binary — JCTETIME Estimated execution time, in seconds2 
116 [74 | SMF26ELN | 4 |binary |JCTESTLN | Estimated outputlines*# = = sid 
124 | 7C SMF26FRM EBCDIC | JCTFORMS Output form number. If the source field contains four or 
fewer characters, SMF26FRM is set. Otherwise, this field is 
set to blanks, and the contents of the source field appears 
only in SMF26EFM, described under the Routing Section 
later in this record. 
1The job name and the time and date that the reader recognized the JOB card for this (Continued) 
job constitute the job log identification. 





2These fields are JES2-defined subfields from the accounting information field in the JOB card or default values assigned for 
this job or from /*JOBPARM, JES2 control card. 


3These fields are defined as follows: X’0100’ indicates local routing; X‘nnrr’ is remote routing; and X‘OOnn’ indicates special 
local routing. If more than 255 remotes are specified for the system, this field is set to zero. The routing section has the 
expanded route codes that should be used if these fields are zero. See the Routing Section described later in this record. 
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Coffee [Name [Usnwth [Fommat | Source] ———=~emerintion 
JCTLINCT Lines per page 
132 SMF26PRR JCTPROUT 


84 
)134 | 86 | SMF26PUR JCTPUOUT 
SMF26PDD | 8 | EBCDIC | JCTPROCN 


Job print route code 
Job punch route code 


Procedure DDNAME used for JCL conversion 


Events Section: 


144 | 90 SMF26LN2 binary internal Length of events section, including this field 


Trae [a2 | swr26nva reso 
14894 | SMF26RPT | 4 [binary | JCTRDROF Reader stop time, in hundredths of a second 


lose fall SMF26RPD > oor JCTRDTOF Reader stop date, in the form OOYYDDDF where F is 
the sign 


/156 | 9C _ SMF 26CST | 4 [binary | JCTCNVON Converter start time, in hundredths of a second 


packed Converter start date, in the form OOY YDDDF where F 
is the sign 


JCTCDTON 
AS SMF 26CPT | 4 [binary | JCTCNVOF Converter stop time, in hundredths of a second 


bal ae SMF26CPD [7 eer JCTCDTOF Converter stop date, in the form OOY YDDDF where F | 
is the sign 


SMF 26XST | 4 [binary | JCTXEQON Execution processor start time, in hundredths of a second 


176 packed | JCTXDTON Execution processor start date, in the form OOY YDDDF 
where F is the sign 


| B4 | SMF26XPT | 4  |binary | JCTXEQOF Execution processor stop time, in hundredths of a second 


B8 packed | JCTXDTOF Execution processor stop date, in the form OOY YDDDF 
where F is the sign 


SMF260ST i a | binary | JCTOUTON Output processor start time, in hundredths of a second 


co packed | JCTODTON Output processor start date, in the form OOY YDDDF 
where F is the sign 


| 196 | C4 SMF260PT any binary | JCTOUTOF Output processor stop time, in hundredths of a second 


SMF260PD packed | JCTODTOF Output processor stop date, in the form OOY YDDDF 
where F is the sign 
Actuals Section: 
binary internal Length of actuals section, including this field 


204 | CC SMF26LN3 i 
|206 | ce | sMF26RV4 binery | | ‘Reserved 
binary | JCTCARDS Number of input cards for job. This field includes JCL and 
SYSIN cards. 


binary |JCTLINES Number of output lines generated to spool 


[212 [ba | SMF26XIN 
|} 216 | D8 | SMF26XPU binary | JCTPUNCH Number of punched cards generated to spool 


| 220 | DC | SMF26RID | EBCDIC Input processor system (CPU) identification 

| 224] G0 | smF26ciD | 4 |[EBCDIC Conversion processor system (CPU) identification 
/228 | £4 | SMF26xID | 4 | EBCDIC Execution processor system (CPU) identification 
} 232 | E8 | sMF260ID | 4  |EBCDIC Output processor system (CPU) identification 


2These fields are JES2-defined subfields from the accounting information field in the JOB card or default values assigned for 
this job or from /*JOBPARM, JES2 control card. 


3These fields are defined as follows: X‘Q100’ indicates local routing; X‘nnrr’ is remote routing; and X‘OOnn’ indicates special 
local routing. If more than 255 remotes are specified for the system, this field is set to zero. The routing section has the 
expanded route codes that should be used if these fields are zero. See the Routing Section described later in this record. 
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Tone [Name [tenets [Format | Sowee [CDmseinton 


Network Section: 
+0 SMF26LN4 binary Length of network section including this field 


EE 
pa [| SweaeNIO [4 | EBCOIE [CTNISIO [Tob wanaminerayatem dentin 
ca [re | swrzenst | @ [eine [SveTT | debwanamivermaretine 
re [se | swraenso_|@[packes_[SVOTT | Jobtranemitternare@ste 
Tis [rio | -swrzener_[ 4 | binary [svo11 | dob Wwansmivternoptime 
[20 [rie | swraeneo | 4 [pected [Svo1 | sob vronemittersop dee 
[eas [30 | swr2enon | 8 [escoic [NITNODE | Oriinalnodename 
[36 [ae | swraenxn [8 | ESCDIC|NITNODE | Executonnadenome 
a 
SMF26NLN EBCDIC | NITNODE Last node name 
Routing Section: 
SMF26LN5 binary internal Length of “e section including this field 
rea [o2 | gwraainn [4 [oinwy [uernUTE [eto wset 
[oe [ve_[ swrzseno | « [binary [JeTeROuT | Deteueprintroecode? 
SMF26PUD binary JCTPUOUT Default punch route code 
Print Section: 
SMF26LN6 binary internal Length of print section including this field 
Tea [oa owraseet |e [ory [ucTesTay | —enimawd SYSOUT bv eure 
cs_[-s | swrzexar | 4 [sinay [scTavres | Actual SySOUTbyiecoum 


SMF26EPG | 4 [binary | JGTESTPG 
SMF26XPG | 4 [binary | JCTPAGES 


+18 | +12 EBCDIC | JCTFORMS Output form number. This field is set regardless af the 
number of characters in the forms field. 


1 These fields are defined as fallows: X‘00010000’ indicates lacal routing; X’nnrrennnn’ indicates remote routing; and 
X‘0000nnnn’ indicates special local routing. This field is always set regardless of the number of remotes specified for 
the system. 







































































2For page mode data sets, JES2 updates the page count when it encounters a “begin page”’ indicator in the data stream header, 
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Record Type 26 (1A) — JES3 Job Purge 


Record type 26 is written by [ATPURG at job purge after all SYSOUT for the job 
is processed. This record identifies the job by job log identification, JES3-assigned 
job number, and programmer’s name. 


Record type 26 also contains operating information such as message class, job 
class, JES3 job selection priority, JES3 logical input device name, execution time, 
output lines, output punched cards, deadline schedule type, deadline schedule time 
and date, and the start and stop times and dates for the reader, the converter, the 
execution processor, and the output processor. Its length is 418 bytes. 


Note: The format of all fields in this record are binary unless data is entered 
in the field. 


The format is: 


Torte [Nemo [Length] Format | Sows [SSC om 


po | o | smrz6Len | 2 | binary | internal | Record length 
Segment descriptor 


SMF26FLG 1 binary SVC 83 System indicator 
Bit Meaning When Set 
0-5 Reserved 
6 VS$2 
7 Reserved 


/5 | 6 | smrz6Rty 


SMF26TME binary SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 
























A SMF26DTE packed SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 
) Ee SMF26SID EBCDIC | JMRCPUID System identification (taken from SID parameter) 
120 SMF26JBN EBCDIC | IATISJB Job name! (taken from job’s RESQ) 


1A SMF26RST binary IATXTOD macro Time, in hundredths of a second, reader recognized the 
(Set by IATISJB) | JOB card for this job! 
SMF26RSD packed IATXTOD macro Date reader recognized the JOB card for this job, in the 
(Set by IATISJB) | formOOYYDDDF where F is the sign? 
SMF 26U IF EBCDIC | JMRUSEID User identification (taken from common exit parameter 
(Set by IATPURG)| area) 


Subsystem identification — X‘0005’ signifies JES3 


2A SMF 26RSV 


1The jab name and the time and date that the reader recognized the JOB (Continued) 
card for this job constitute the job log identification. 


48 Entry type indicator: 










Bit Meaning when set 
0-4 Descriptor section present 











binary 
1 Events section present 
2 Actuals section present 
3-4 Reserved 
5 Print section present 
Reserved 
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c 


Tories [Nene [Umut] ome [| Souee[SCepton 


Descriptor Section 


/Reserved sss 


|__| Re information indicator 


Bit Meaning When Set 


Dependent job (//* NET card processed) 

Deadline scheduling (DEADLINE parameter was 
specified on //* MAIN card) 

Deadline job met deadline 

Process job (//* PROCESS card processed) 

Job left system via NJP (network job processing) 

Job entered system via NJP 


SMF26LN1 + [oony | nwt | aanctonein mnt Length of descriptor section, including this field 


ae" SMF26RV1 | 2 | binary | 
Job left system via DJ (dump job) 


SMF26IN3 binary 
IATISNT 
IATISDL 
IATPURG 
IATISPR 
IATNJDJ 
IATNJDJ 
IATDJOT 
IATDJIN Job entered system via DJ 
SMF 26INF binary Job information indicator 
Bit Meaning When Set 
IATISJB 0 Job priority (taken from PRT Y= parameter on 
JOB card) 
IATIIDR 1 Job processed by preexec setup 
IATISJB 2 TYPRUN=HOLD was specified on JOB card 
3-4 Reserved 
IATISJB 5 Job was entered on internal reader 
JATMSIN for ASP 6 Job was rerun on an ASP main reader or a JES3 
or [|ATMSMS for reader 
JES3 
IATPURG Job was canceled by the operator 


SMF26JNM EBCDIC | IATISJB or JES 3-assigned job number (taken from job's RESQ) 
[ATPURG 


SMF26J1D EBCDIC | IATISJB Job identification in the form xxxOyyyy where yyyy is the 
JES3-assigned job number and xxx is: 
JOB — for normal JES3 job 
STC — for started task control job 
TSU — for TSO job 












SMF26NAM = EBCDIC | JATIIPR Programmer's name (taken from JOB card) 
This field is blank if the default is used or if a valid 
SMF 26XPI binary IATISJB if JES3 job selection priority when the job was initially 
PRT Y= parameter read (taken from: 1) PRT Y= parameter on JOB card, 
or IATISEN 2) class default priority from main processor job class 
table, or 3) default priority from TVT) 
SMF26DEV EBCDIC aaa! or JES3 logical input device name, or user identification if 
IATNJDJ if NJP TSO job, or line name if NJP job 


= SMF26MSG EBCDIC | IATISJB Message class (taken from MSGCLASS= parameter on 
JOB card) 
a CLASS= parameter is specified on the //* MAIN card. 
SMF26XPS binary [ATMSIN for JES3 job selection priority when the job was selected 
ASP, [|ATMSMS 
———=4 JES3 


SMF26CLS EBCDIC | IATISJB Job class (taken from CLASS= parameter on JOB card). 
See offset 172. 
(taken from job’s RESQ) 


74 SMF26ELN binary IATISMN if Estimated output lines or from LINES= parameter on 
LINES= parameter | //* MAIN card or default (JOBLINES field in TVT times 
or !ATISJB if 1000) ) 
default 





(Continued) 
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[oes [Nene [tm] Format [Source [Cito 


IATISMN if | Estimated output punched cards (taken from CARDS= 


CARDS= parameter| parameter on //* MAIN card or default (JOBCARDS 
or IATISJB if field in TVT times 100)) 
default 


7C SMF26DTY EBCDIC | IATISDL Deadline schedule type (taken from DEADLINE parameter 
on //* MAIN card). Valid types are A-Z and 0-9. 
SMF26IGP EBCDIC| IATISJB JES3 logical input device group name 


| 80 
sina 























EBCDIC | IATISMN if Procedure DDNAME used for JCL conversion (taken from 
PROC= parameter | PROC= parameter on //* MAIN card or default 
or IATISJB if (IATPLBST)) 


default 


EBCDIC |] IATNJDJ Name of system to which job is sent via NJP 

EBCDIC | IATNJDJ Name of local NJP terminal supplied by the JES3 
initialization deck 

EBCDIC | IATISNT Identification of dependent job net to which this job 
belongs (taken from //* NET card) 

binary IATISDL Deadline schedule time, in hundredths of a second (taken 
from DEADLINE parameter on //* MAIN card) 

packed IATISDL Deadline schedule date, in the form OOY YDDDF where F 


is the sign (taken from DEADLINE parameter on 
EBCDIC | IATISMN if 


//* MAIN card) 
CLASS= parameter 


SMF26NJO 


SMF26NJI 
es SMF26NET 


172 SMF26DDT 
176 | SMF26CLN 
























Job class (taken from CLASS= parameter on //* MAIN 
card if valid, or the default (JSS3BATCH)) 





or I|ATISJB 
if default 
Events Section: a 
184 | B4 SMF26LN2 binary Length of events section, including this field 


1ATXTOD macro 
(Set by IATISEN) 


IATXTOD macro Reader stop date in the form OOY YDDDF where F is 
(Set by IATISEN) the sign. This field is filled in during JOB card processing. 


binary IATXTOD macro Converter start time, in hundredths of a second. This field 
(Set by IATIIDR) is filled in following the JES3 LOGIN of the interpreter job. 

CVTDATE Converter start date, in the form OOY YDDDF where F 

(Set by L|ATIIDR) is the sign. This field is filled in following the JES3 LOGIN 


SMF26CSD 
of the interpreter job. 
cc SMF26CPT binary IATXTOD macro Converter stop time, in hundredths of a second. This field 
(Set by IATIIDR) is filled in at the end of the interpreter function. 
SMF 26CPD packed CVTDATE Converter stop date, in the form 00YYDDDF where F 
(Set by IATIIDR) is the sign. This field is filled in at the end of the interpreter 
function. 
SMF26XST binary |ATXTOD macro Execution processor start time, in hundredths of a second. 
(Set by IATMSMS) | This field is filled in when the job is scheduled to run ona 
JES3 local or global processor. 
SMF26XSD packed CVTDATE (Set by | Execution processor start date, in the form OO0Y Y DDDF 
|IATMSMS) where F is the sign. This field is filled in when the job is 
scheduled to run on a JES3 local or global processor. 
DC SMF 26 XPT binary IATXTOD macro Execution processor stop time, in hundredths of a 
(Set by |ATMSMS) | second. This field is filled in when the job is terminated 
on a JES3 local or global processor. 
SMF26XPD packed IATXTOD macro Execution processor stop date, in the form 0OO0Y YDDDF 
(Set by IATMSMS) | where F is the sign. This field is filled in when the job is 
terminated on a JES3 local or global processor. 


(Continued) 








Reader stop time, in hundredths of a second. This field is 


filled in during JOB card processing. 


binary 


188 SMF26RPT 
lho SMF26RPD 
ies SMF26CST 





cked 





packed 
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J 








IATXTOD macro Output processor start time, in hundredths of a second. 
(Set by I|ATOSDR) | This field is filled in when output service starts 
to process the job’s data sets. 














[ATXTOD macro 
(Set by IATOSDR) 


Output processor start date, in the form OOY YODDF 
where F is the sign. This field is filled in when output 
service starts to process the job's cata sets. 







wi — i ~ 






Output processor stop time, in hundredths of a second. 
This field is filled in: 1) when an RQ is removed from the 
writer queue, 2) when all output OSEs are deleted/ 
released, and 3) when a request from the SYSOUT 
interface is processed. 




















Output processor stop date, in the form OOY YDDDF where 
F is the sign. This field is filled in: 1) when an RQ is 
removed from the writer queue, 2) when all output OSEs 


SMF260PT binary | IATXTOD macro. | 
(Set by [|ATOSWS) 
SMF260PD packed IATXTOD macro 
are deleted/released, and 3) when a request from the 
SYSOUT interface is processed. 


(Set by IATOSWS) 
Actuals Section: 
244 | F4 SMF 26LN3 | binary Length of actuals section, including this field 


[aaa [Fe | swracnve | 2 [oir [sid Reed 


binary IATISEN Number of input cards for job. This field includes JCL 
and SYSIN cards. 

FC SMF26XLN binary IATMSMS Number of output lines generated to spool. This field is 
filled in when the job is terminated on a JES3 local or 
global processor. 

SMF26XPU | binary |IATMSMS Number of punched cards generated to spool. This field is 
filled in when the job is terminated on a JES3 locai or 
global processor. 
TVTCPUID Input processor system (CPU) identification 
(Set by |ATISJB) 
TVTCPUID Conversion processor system (CPU) identification 
(Set by IATIIDR) 


268 SMF26X!ID TVTCPUID Execution processor system (CPU) identification 
(Set by |ATMSMS) 


2 | ne] Saraeone | *[FPeP | teyiarosons | Cunt moemernmem (ere emiienion 
(Set by IATOSDR) 

we [ra| suraeiar [a2 [escore| (| Rewnedlorimecouninefea 
[sia] ae [Noewwnio | @ | e0coic | imma | Networking lenin NER 
[326 [146 [_NUEIMALN | 2 [binary | NIEUMRSZ | Length of data tet follows incuging hs od 
[ses] 148 [naevoano | 2 [eacore| ninGulO | orgneljpnumeer 
[sso [aq _nsei0enm [8 [eBcDIG | NINGINAM | Job name 

[ase] 162 [_nvexeaw | @ | escorc | NinGXEGN | Execution noderane 
[396 [isa] NIEPRGMA | 20 [ESCDIC | WHGPRGN | Proganmernane 
raes[ ree | ueusar |[@ [e8CDIC | WINGUSID | Origin or nouty war genifeaton 
Tara[v7e [_waeacct | [£06016 | WiMGACT | Neworkingascountnumeer 
[aaa [17e | _nueerr | @ | €BcDIG | NIHGDEPT | Programmer's depermant number 
[360 [186 [NiESLOG | @ | €8CDIC | NIHGBLOG | Propenmars bulaing numear 
[ase [1a [ MieRCOM |e [ESCOIC | NINGROOM | Programmers room number 
[06 [196 | Nexeau | 8 [ESCDIG | NINGKEGU | Execution wer iseeiter 
ate [iee | _setrans | «[oimry [id Reeves 
aie [ taal_swrassnc | « [oinery | Setby IATURG | Number ofspooitesoras 
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[aries [Nene loves [Forme [Sours] Dmminon 


Print Section: 
SMF26LNG binary Length of print section including this field 


res SMF26EBT / 4 | binary TVTMAXB Estimated SYSOUT byte count 





46 [se SMF26XBT ) 4 | binary JSQACTB Actual SYSOUT byte count 


+14 | +E SMF26XPG binary JSQAC TP Actual page count. For page mode data sets, JES3 updates 
the page count when it encounters a ‘‘begin page”’ indicator 
in the data stream header. 
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Record Type 30 (1E) — Common Address Space Work Record 


Record type 30 is written by IEFTB721 at normal or abnormal termination of a 
batch job or step, a TSO session, or a started task, by IEEMB836 at the expiration 
of an accounting interval if INTERVAL is specified in SMFPRMxx, by IEFSMFIE 
at the start of a job or at the start of the first step after a warm start, or by 
IFAEASI at the expiration of an accounting interval for a system address space. 


The type 30 record consolidates the data in the type 4, 5, 20, 34, 35, and 40 
records. The record identifies the job and job step by the job log identification, 
step name, number of the step within the job, user identification, program name, 
performance group number and JES job number. If accounting numbers (which 
can be alphameric) are specified in the JOB or EXEC statements, they are included. 
For job start records (subtype 1} and job termination records (subtype 5), 
accounting numbers are taken from the job card. For all other subtypes, the 
accounting numbers are taken from the EXEC card. (The subtype is identified in 
offset O of the subsystem section). In addition, the interval record (subtype 2) and 
the step termination record (subtype 3), contain data that represents the change 
since the last interval record or the start of the step. 


The record also contains operation information such as the job and step start 
and end times, step CPU time, step termination status, number of records in 
DD DATA and DD * data sets for the step and job, device allocation start time, 
problem program start time, and storage protect key. The record also contains the 
number of page-ins, page-outs, swap-ins, and swap-outs for both VIO and non-VIO 
data sets. The record contains an entry for each data set that was defined by a DD 
statement or dynamic allocation. Each entry lists the device class, unit type, 
device number, EXCP count, and device connect time for the data set. 


The length of record type 30 is variable. 


Because system address spaces do not use full function start, the subtype 6 
record is incomplete; that is, only certain fields in each section are valid. All 
unused fields are set to zero. The valid fields in each section are: 


Section Offset Field Name 

Header and Defining Section 0 through 104 All fields 

Subsystem Section +0 SMF30TYP 
+2 SMF30RSI 
+4 SMF30RVN 
+6 SMF30PMN 
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Section Offset Field Name 








Identification +0 SMF30JBN 
Section ped, SMF30PGN 
Storage and Paging +8 SMF30PGI 
Section - +12 SMF30PGO 
+16 SMF30REC 
+20 SMF30NSW 
+24 SMF30PSI 
+28 SMF30PSO 
+32 SMF30 VPI 
+36 SMF30VPO 
+40 SMF30VPR 
+44 SMF30CPI 
+48 SMF30CPR 
+52 SMF30LPI 
+56 SMF30LPR 
+60 SMF30PST 
+64 SMF30PSC 
Performance Section +0 SMF30SRV 
+4 SMF30CSU 
+8 SMF30SRB 
+12 SMF30I0 
+16 SMF30MSO 
+20 SMF30TAT 
+28 SMF30RES 
+32 SMF30TRS 
I/O Activity Section +4 SMF30TEP 
Processor Accounting +0 SMF30PTY 
Section +4 SMF30CPT 
+8 SMF30CPS 


The subtype 6 records are written only at the expiration of an interval; the values 
are cumulative and indicate data collected since the initialization of the address 
space. If a system address space later goes through full function start, data is not 
reported for the period between the expiration of the last interval and the time 
that the address space goes through full function start. 


For more information on system address spaces and full function start, refer to 
Initialization and Tuning. 


Because some of the information necessary to complete a field is not always 
available when a type 30 record is written, some fields might be empty. For 
example, the SMF30AST, SMF30PPS, SMF30SIT, and SMF30STD fields are not 
filled in for a job start record (subtype 1). 
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Notes: 


l. 


Data sets are recorded in the order of the DD statements; they are not identified 
by name. However, the ddname is included in the record. (A user written 
IEFUJV exit routine can record this order as each statement is validated). For 
concatenated DD statements, the ddname is the same on each entry. 


. For more information on EXCP count and CPU time, see Chapters 8 and 9, 


respectively. 


. Duplicate EXCP entries are consolidated. That is, if the ddname, device class, 


unit type, channel address, and unit address are the same for the entries in the 
TCTTIOT, the EXCP count is accumulated in one entry in the type 30 record. 


. If a section is not included in the record, the “number of” entry is zero. For 


example, subtype 1 does not have a completion segment, and SMF30TON is 
set to zero to indicate this. 


. If the IEFUSI exit changes the size of the private area, a flag is set in SMF30SFL 


in the paging and storage section. 


. The maximum length of the type 30 record is 32,756 bytes. If the number of 


DD statments is such that the length would exceed the maximum length, one 

or more additional type 30 records are produced. The additional records contain 
only the header, self-defining, product, identification, and EXCP sections. When 
examining a type 30 record, SMF30EON indicates the number of EXCP section 
in the record you are examining; SMF30EOR field indicates the number of EXCP 
sections in all subsequent type 30 records for the job. 
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The format is: 


ee 


SMF30F LG binary SVC eenat System indicator 
BIT Meaning When Set 
0 Subsystem identification follows system identification 
14 Reserved 
MVS/XA 
VS2 
VS1 


SMF3OTME piney SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 
ae SMF30DTE aa SVC 83 Date record was moved to SMF buffer, in the form 


OOY YDDDF, where F is the sign. For a TSO session, 
this date is the 2 logott date. 

| — | smFsosio | 4 |EBCDIC|SMcASID | System identification 

ir son [+a [See 


— Offset to subsystem section from start of record, including 
the ROW 


binary internal Offset to identification section from start of record, 
including the ROW 


ss SMF3OILN ee Length of identification section 
fbinary | internal Number of identification sections 


SM SMESOION 2 [inary Offset to 1/O activity section from start of record, 
including the ROW 


| 48 | 2E | SMF30UON 2 Tener Tinternar Number of |/O activity sections 


SMF30TOF binary Offset to completion saction from start of record, 
including the RDW 


SMF30COF binary Offset to processor section from start of record, 
including the ROW 


eo [ac | swrsocin | 2 [binary [internat | Length of procesormction SSCS 
| 62 | 3& | SMF30CON| 2 | binary [internal |_ Number ofprocessorsections 


binary internal Offset to accounting section from start of record, 
including the ROW 


— binary Offset to storage section from start of record, including 
the ROW 


76 [ac | SaFS0RLN | 2 [binary [internat | Length of forage ection 
Tye [4e_[ swesonow | a [einen linen | "Name of sores sation 


0 | 80 | smrsoror | 4 | binary Offset to performance section from start of record, 


including the ROW 
eee [sure Tee Length of performance section 
| 56 | SMF3OPON | 2 | binary | internal Number of performance sections 
Rac nl Offset to operator section from start of record, 
including the ROW 
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o 








L 


h 
| SE | SMF3000N| 2 | binary — internal Number of operator sections 


Offset to EXCP section from start of record, 
including the RDW 


60 | SMF30EOF ee | internal 


| 64 | SMF30ELN internal 
| 66 | SMF30EON | 2 |binary | internal Number of EXCP sections in this record 

| 104 | 68 | SMF30EOR | 2 |binary | internal Number of EXCP sections in subsequent records 

5 = Job termination 


Subsystem Section: 
internal 
6 = System address space 


SMF30OTYP binary 
| +2 {| |smrsorsi1 | 2 | | iE Reserved a s—“‘“CSCS*sCY 
+4 | SMF30RVN| 2 [EBCDIC|internal | Record version number— 02) 
| +6 | | SMF30PNM| 8 ~~ [EBCDIC| internal | Subsystem orproductname 


Identification Section: 
+0 SMF30JBN JMRJOB Job or session name” 
il UE ies a SCTPGMNM Program name (taken from PGM= parameter on EXEC 


card). If a backward reference was used (SCTSTYPE equals 
X’80’)s then this field contains PGM=*.OD. 

| +6} SMF30STM | 8 | EBCDIC| SCTSNAME Step name (taken from name on EXEC card) 

a | JMRUSEID User identification (taken from common exit parameter 
area) 

| +40] | SMF30STN | 2 | binary | LCTSNUMB Step number (first step = 1, etc.) 

| 442] | SMF30CLS | 4 | EBCDIC JCTJCSMF Job class. Blank for TSO session or started tasks 

esp | tt | Reseed ee ——“—*i—s—s———C—C—sY 

| +44{ | smF3zopGn | 2 __| binary | OUCBNPG Job performance group number 

| +as| | smrsoupT | 2 [binary | JCTJPRTY JES input priority? 

__+48| | smrsoast | 4 | binary _| TCTAST 

| +52| | SMF30PPS | 4 | binary | TCTPPST Problem program start time, in hundredths of a second 


+56 SMF30SIT binary JCTJMRSS Time, in hundredths of a second, initiator selected this step 

or job 
SMF30STD packed | JCTSSD Date initiator selected this step, in the form OOY YDDDF 

where F is the sign 

+64 SMF30RST binary |JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job 

packed | JMREDATE Date reader recognized the JOB card for this job, in the 

form OOYYDDDF where F is the sign” 


+72 a SMF30RET > binary Time, in hundredths of a second, reader recognized the end 
of the job or started task (reader stop time). For TSO, this 
is the logon enqueue time. 
| [oro 8 frees |iinonsres Date, in the form OQOY YODDF, where F is the sign, reader 


recognized the end of the batch job or started task (reader 
stop date). For TSO, it is the logon enqueue date. 

‘Step termination records are produced only when interval accounting is specified. The data represents the activity since 

the last interval record was written. 





Length of EXCP section 


fe) 






Sub type identification 
1 = Job start 

2 = Interval 

3 = Step termination 
4 = Step total 


1 


g 























“The job name and the time and date that the reader recognized the JOB card for this job constitute the job log identification. 


31f no value is specified for the PRTY parameter on the JOB card, this field contains: 
e For JES3, the default priority specified on the JES3 STANDARDS initialization card 
@ For JES2, a zero. 
Note that JES2 does not use the priority value reported in this field. (The JES2 job selection 
priority is requested via the JES2 PRIORITY control statement.) 
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identification Section (continued) 
+80 |}+50| SMF3OUSR 20 ACTPRGNM Programmers name 


+116] +74 SMF30TID ACEETRMF RACF terminal ID 
O = RACE is not active; user is not a terminal user. 


I/O Activity Section: 

+90 _+0 SMF30INP binary SCTSMF Number of card-image records in DD DATA and DD* data 
sets read by the reader for the map. This field is not set for 
subtypes 2 and 3. 


SMF30TEP | 4 [binary | ASCBIOSC Total blocks transferred (accumulated EXCP counts) 


SMF30TPT | 4 [binary | TCTLOUT Number of TPUTS for a TSO session4 
SMF30TGT | 4 | binary TCTLIN Number of TGETS for a TSO session? 
JMRRDR 


il bail 9 for TSO ss 


O — for TSO sessions or started tasks 


+17 | +11 SMF30RDT binary WMRRDR Reader device type 
O — for TSO sassions or started tasks 
+18 14+12| SMF30TCN binary ASCBDCTI Tota! device connect time for this address space 
—TCTDCTI 


+22 |+164 SMF30MFL binary Flag word 
Bit Meaning When Set 7 
0 Device connect time may be incorrect 
1-31 Reserved 


Completion Section: 

SMF30SCC binary |TCBCMPC Step completion code: 
X‘Occc’ indicates system ABEND in the job step where ccc 
is the system ABEND code, (See Message Library: 
System Codes.) 
X‘8ecc’ indicates user ABEND in the job step where ccc is 
the user ABEND code. 
X‘nnnn’ indicates normal completion where nnnn is the 
contents of the two low-order bytes in register 15 at 
termination. 
X’0000' indicates either: 
(1) the job step was flushed (not executed) beceuse of an 

error during allocation or in a preceding job step, or 

(2) normal job completion with a return code of 0. 


(Continued) 


















‘Step termination records are produced only when interval accounting is specified. The data represents 
the activity since the last interval record was written. 


The job name and the time and date that the reader recognized the JOB card for this job constitute the 
job log identification. 


Sif no value is specified for the PRT Y parameter on the JOB card, this field contains: 


@ For JES3, the default priority specified on the JES3 STANDARDS initialization card 

e For JES2, a zero. 

Note that JES2 does not use the priority value reported in this field. (The JES2 job selection priority 
is requested via the JES2 PRIORITY control statement.) 


Aig a batch job or a started task successfully executes TPUTs, this field might be non-zero 
for batch jobs or started tasks. 


Oi this flag is set, the SRM disabled the channel measurement while the job was executing. If 


channel measurement is disabled, device connect time is not recorded. Therefore, if this bit is 
set, SMF3O0TCN and SMF30DCT reflects less than the actual total connect time. 
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[overs [nome [uh [Fromm | Sowe -[OOS~*~« ten 


Completed Section (continued): 


SMF3OST I binary Step termination indicator: 


Bit Meaning When Set 
0-1 Reserved 
JCTJMRCL Canceled by exit IEFUJI 
JCTJMRCL Canceled by exit I|EFUS| 
JCTJMRCL Canceled by exit IEFACTRT 
JCTSTEPR Step is to be restarted 
TCBFA If O, normal completion. If 1, ABEND. If step 


completion code equals 0322 or 0522, LEFUTL 
caused ABEND. If step completion code equals 
0722, |EFUSO caused ABEND. 
TCTHWM If O, normal completion. If 1, step was flushed. 
TCT EXCP counts might be incorrect because the 
record did not include all the DD statements. 
SMF3OISK Previous interval record was not written because an 
error Occurred. The cumulative count might be 
incorrect because the counters were cleared. 
10-15 Reserved 





Address space dispatching priority (taken from DPRT Y= 
parameter on EXEC card or the APG value in CVTAPG). 


—2_{Surson binary ASCBEJST Step CPU time under TCB in hundredths of a second 

or ACTJTIME 

— TCTEJST 

SMF30CPS binary ASCBSRBT 

or SCTSRBT 

— TCTSRBT 

+ TCTITCB 

+ TCTISRB 


+20 +14 | SMF30JVU binary ASCBEVST Step vector usage time in hundredths of a second 
or SCTTVFUT 
— TCTEVFUT 

+24 +18 | SMFSOIVU binary ASCBEVST Initiator vector usage time in hundredths of a second 
+ TCTIVFUT 


+28 +1C | SMF3O0JVA binary ASCBVFAT Step vector affinity time in hundredth of a second 
or SCTTVFAT 
—~ TCTEVFAT 
SMF30IVA binary ASCBVEAT Initiator vector affinity time in hundredths of a second 
+ —— 


)436 | +24 — SMF S30IST 4 | EBCDIC | internal =| Interval start time for type 3 | Interval start time for type 3 subtype 2 and3 records _| 2 and | Interval start time for type 3 subtype 2 and3 records _| records 
} +40 | +28 SMF30IDT a EBCDIC Interval start date for type 30 subtype 2 and 3 records 


(Continued) 















Step CPU time under SRB in hundredths of a second 
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ortets [Name | terath [Format | Sowe -[~S~S~*~*~*~ anton J 


EXCP Section: ® 
binary UCBTBYT3 Seta class 






SMF30DEV 


SME30UTP _ SrsouTe | 1 finery UCBTBYT4 |Unittvpee — —s—SsSSSSSiCisSSSSS type 


| SMF30DDN| 8 — | EBCDIC TICOEDDODNM OD name used to access the data set 


= _enreenen sooo} S cor’ TCTOCTR — count of blocks issued for the device against the data 
TCTDCRS 


+10 SMF30BSZ binary TCT BLKSZ Largest blocksize of the data set 
Bit When Set 
0 Indicates changed blocksize for the data set® 
1-15 Largest blocksize of the data set 


+12 SMF30DCT binary TCTCONN Device connect time for this data set {in 128 micro- 
—TCTCONNS second units) 
Accounting Section:? 
SMF30ACL binary Length of accounting section, excluding this field 


po var | var | EBCDIC EXEC statement Job or step accounting field 


binary Reserved. Note that SMF30RGN, formerly a two-byte 
field at this offset, has been increased to four bytes and 
moved to the end of the Storage and Paging Section. 
SMF30SFL binary Storage Flags! 9 
Bit Meaning When Set 
0 VER is specified! | 
1 |EFUSI changed region limit values for the . 
extended private area ; 
2-7 Reserved 


SMF30SPK binary TCBPKF Storage protect key, in the form xxxxQ000 where xxxx is 
the key 0 


+4 +4 SMF3OPRV 2 binary TCT LWM/1024 Largest amount of storage used from bottom of private 
area, in 1K units. This storage area includes subpools 
0-127, 251 and 252. If ADDRSPC=REAL is specified, 
this field equals the amount of contiguous real storage 
that was used. 19 

+6 | +6 SMF30SYS 2 binary TCTHWM/1024 Largest amount of storage used from top of private area, 
in 1K units. This storage area includes the LSQA and 
SWA (subpools 229, 230, 236, 237 and 253-255). If 
ADDRSPC=REAL is specified, this field equals the amount 
of storage used that was not from the contiguous real 
storage reserved for the program. 


SMF30PGI ay OUXBPIN Number of non-Vi0O, non-swap page-ins for this step. This 


field includes page-ins required through page faults, specific 
5For each device assigned to each data sat there is a 22-byte EXCP section. (Continued) 


page requests, and page fixes. [t does not include page 
reclaims, page-ins for VIO data sets, pages that are swapped 
7Entries for virtual \/O data sets are zero for class and type, and X’7FFF’ for device number. If the high order bit of the device 
field is On, it indicates a virtual device. 













SMF30RSV 


I 




















in, and page-ins for the common area. 


BPost processors should use this field to avoid the possibility of negative numbers. 


Seach entry in an accounting field contains the length of the field in the first byte, followed by the field. An omitted field is 
indicated by a O in the first byte. 


10 i¢ storage was not allocated (job step was flushed), these fields equal zero. 


11 This bit has no meaning for subtype 5 records. 
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Storage and Paging Section (continued): 
SMF 30PGO 













OUXBPOUT Number of non-V!O, non-swap page-outs for this step. This 


field includes page-outs required through specific page 
requests as well as those pages stolen by the paging super- 
visor as a result of infrequent use. It does not include 
page-outs for VIO data sets, pages that are swapped out, 
and page-outs for the common area. 


SMF30REC | 4 | binary — | OUXBPREC Number of non-VIO reclaims 


+14 SMF 30NSW eee OUxSPREC Number of address space swap sequence. (A swap 
+24 


sequence consists of an address space swap-Out and 
+ SMF30PS| aa OUXBSPIN 


swap-in.) 
SMF30PSO pe OUXBSPOT 
-— eee 


SMF30VPO a OUXBVAMO 


































oO 


Number of pages swapped in. This field includes: (LSQA, 
fixed pages, and those pagas that the real storage manager 
determined to be active when the address space was 
swapped in. It does not include page reclaims or pages 
found in storage during the swap-in process (such as pages 
Srought in via SRB’'s started after completion of swap-in 
State 1 processing). 














O 


Number of pages swapped out. This field includes: LSQA, 
private area fixed pages, and private area non-fixed changad 
pages. 


Number of VIO page-ins for this step. This field includes 
wage-ins resulting from page faults or specific page requests 
ona VIO window. |t does not include VIO swap-in or 

page-ins for the common area. 









+2 


© 






a 


+2 Number of VIO page-outs for this step. This field includes 
page-outs resulting from specific page requests ona VIO 
window as well as those pages stolen by the paging super- 
visor as a result of infrequent use. It does not include VIO 


swap-Outs Or page-outs for the common area, 







ey 
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Description 


ors [ame [coat | Format 


Storage and Paging Section (continued): 
+40 28 SMF30VPR 4 binary OUXBVAMR 
Maximum virtual storage in bytes allocated from the 


+80 SMF30ARB binary TCTHWM 
LSQA and SWA subpools below 16 megabytes 

+84 SMF 30EAR binary TCTEHWM Maximum virtual storage in bytes allocated from the 
LSQA and SWA subpools above 16 megabytes 

+88 SMF30URB binary TCT LWM Maximum virtual storage in bytes allocated from the 
user subpools below 16 megabytes 

+92 5C SMF30EUR binary TCTELWM Maximum virtual storage in bytes allocated from the 
user subpools above 16 megabytes 


SME30RGN | TCTRSZ*2 Region size established, in 1K units taken from the 


REGION=parameter in the JCL, and rounded up toa 
Performance Section: 
SMF30SRV binary OUXBJBS + 
OUXBTRS 


4K boundary. If ADDRSPC=REAL is specified, this 
field equals the amount of contiguous real storage 
reserved for the program, If the region requested was 
greater than 16 megabytes, the region established resides 
above 16 megabytes, and this field will contain a 
+4 +4 SMF30CSU binary OUXBJCPU + CPU service units 
OUXBTCPU 
+8 +8 SMF30SRB binary OUXBJSRB + SRB service units 
OUXBTSRB 
+12 +C SMF30I0 binary OUXBJIOC + |/O service units 
OU XBTIOC 
+16 +10] SMF30MSO binary OUXBJMSO + MSO service units 
OUXBTMSO 
+20 +14) SMF30TAT binary OUXBJBT + Transaction active time 
OUXBTRT 


Number of VIO reclaims 

Number of common area page-ins 

Number of common area reclaims 

Number of LPA page-ins 

Number of LPA reclaims 

Number of pages stolen from this address space 
Count of CPU page seconds for this address space 
Private area size in bytes, below 16 megabytes 


Private area size in bytes, above 16 megabytes 















Total service units 


minimum value of 32 megabytes. 


+28 | +1C} SMF30RES binary OUXBJBR + Transaction residency time 
OUXBTRR 
+32 +20] SMF30TRS binary OUXBTRC Number of transactions 
0 for all non-TSO users 
Operator Section: 
+0 | +01 SMF30PDM binary TCTPDADS Number of non-specific DASD mounts! @ 


rea [ +4] _smesorao [4 | binary | TCTRDASD | Number of specific DASD moums!? 
/+g |+8 | smMF30PTM | 4 | binary | TCTPTAPE | Number of non-specific tape mounts! 2 

+12 | +c | smrsoreR | 4 | binary |TCTRTAPE Number of specific tape mounts! 2 

rie | Hof smesomTw | 4 | binary | TCTPMSS | Number of nonapecifie MSS mounts?® 


SMF30MSR | 4 | binary TCTRMSS Number of specific MSS mounts 12 


12 The count is increased by one when the mounted volume is verified. Thus, if an incorrect 
volume is mounted the count is not increased even though another mount message ts issued. 
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Record Type 31 (1F) — TIOC Initialization 


Record type 31 is written by IEDAY1 when a MODIFY tcam operator command 

is issued. This record contains the number of time-sharing buffers, buffer size, 
maximum number of output and input buffers allowed per terminal before OWAIT* 
or LWAIT? , OWAIT and RESTART thresholds, number of buffers reserved on the 
free queue, and the size of one terminal status block. Its length is 58 bytes. 


The format is: 


| Offsets | Name | Length | Format | Source | Description 
po fo | Trstten | 2 [binary |ineernal | Record ength 
2 [2 | rristsee | 2 [binary | interne 


TTIRFLG binary System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
: VS2 
Reserved 


Cs_[s | rrncory | 1 [binary [irene | _Recordwee OSS 


TTIRCDTS SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 

TTIRCDTE SVC 83 Dete record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


14 [€ | TTICPUID | 4 | EBCDIC) | System identification (taken from SID perameter) = identification (taken from SID | System identification (taken from SID perameter) = 


TTINBE binary ——— Number of time-sharing buffers 
(In TIOCRPT) 

TTIBUFSE binary | TIOCBFSZ Time-sharing buffer size, in bytes 
(in an 


(22 |16 | TTIRSVRD| 2 |binery__ | Reserves 


TTIOMAX a Maximum number of output buffers allowed per terminal 
(In TIOCRPT) before OWAIT? 

TTIIMAX binary | TIOCAIMX Maximum number of input buffers allowed per terminal 
(in TIOCRPT) before LWAIT2 

TTIOWTH binary | TIOCWTH OWAIT threshold. The number of buffers that must be 

| {in TIOCRPT) freed in order to be freed from OWAIT.+ 

TTIRSTH TIOCRSTH RESTART threshold. The number of buffers that must 

(In TIOCRPT) be freed In order to be freed from LWAIT.2 
20 TTIUSLW binary | TIOCUSLW Number of buffers reserved on the free queue. (Less than 
(in TIOCRPT) this number results in a system-wide LWAIT.2) 
ras [ae | truss [2 [emery | | Red 


TTITSBS binary | TIOCTSBS Size of one terminal status block (TSB) 
(In TIOCRPT) 
apa ree eer eee 


1OWAIT Is the suspension of the program during input/output processing to the terminal 
because no output buffers are available. 


2LWAIT is the locking of the terminal's keyboard because the terminal user filled all of 
the available input buffers. 
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Record Type 32 (20) — TSO User Work Accounting Record 


Record type 32 is written by IEFTB721 at normal or abnormal termination of a 
TSO session or by IEFTB727 at the expiration of a TSO accounting interval. 


To use the type 32 record, you must have installed MVS TSO/E. 


The record contains the names of the commands and the number of times each 
command was used during the session as well as the device connect times for 
each command. For more information see ‘““Transaction Billing” and “TSO 
Command Accounting’. Its length is variable. 


Notes: 


1. TSO commands entered from batch jobs are not counted; type 32 records are 
produced for TSO sessions only. 


2. Aliases of commands are counted in separate entries in the record. For instance, 
SEND and SE are counted as separate commands. 


3. The resource data found under logon (if DETAIL is specified in SMFPRMxx) 
represents the resources used from the start of the session to the time when the 
first command is obtained. 


The format is: 


| Offers | Name [Length | Format | Source | Decription 
oe [oe [swrsccen | 2 [oney [ime | Reomigh 
(2 [2 | swrsases | 2 [binary | ineroat | Soument meron 


SMF32FLG SVC 83 System indicator 
7 VS$1 


Bit Meaning When Set 
[se [s |swrazery [1 [[intema | Records 


SMF32TME binary SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 
SMF32DTE packed | SVC 83 Date racord was moved to SMF buffer, in the form 
OOYYDDDF, where F is the sign 
fe few | 4 | oe System identification (taken from the SID parameter) 
ao “fame ovo OUCBSUBN Subsystem identifier 



















0 Subsystem name follows system identification 
5 MVS/XA 
6 VS2 


















—— | 2 | binary internal Record subtype 
binary internal Offset to product section from start of record, including 
son cipal RDW 
eee F32PLN es internal | Length ofproductsection of product section 





2 | Biers internal Offset to the identification section from start of record, 
including the ROW 


Pe [a SMFS2ILN | 2 | binary | internal | Length of the identification section 
LSMF32I0N | 2 | binary |internal_ Number of identification sections 


including the ROW 
[a4 [2c [ewraacun [2 binary [invernat 


Length of the TSO command section 
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Product Section: 
SMF32TYP binary internal Sub type identification for the record: 
1 = TSO user interval record 
2= TSO user session end record 
3 = TSO user interval record with detail 
4 = TSO user session end record with detail 


+2 | 2 | SMF32AVN| 2 [EBCDIC [internal | Record version number “02 
| 4 | 4 | SMFS2PNM | 8 [EBCDIC Jinternal | Productmame 


identification Section: 
SMF32JBN JMRJOB Job/session name 


a [e [ sara [esene[seramn—[pevan sen 


| +16 | SM | SMF32STM | 8 /EBCDIC |SCTSNAME | Stepname eee name 


SMF32UIF “Sars || ec me — JMRUSEID User identification (taken from common exit parameter 
area) 


[#32 [20 | swrsznm [a [EBcoIc |ssiBi8I0 | JESiob number 
[40-[ 28 | -SMFazsTN | 2 [binary |CCTSNUMB [Step number 
8 2 OO 
(a | 2c | sMraaPGN | 2 [binary [OUCENFG | Job performance group number 
+46 [2 | swroziet | 2 [binary [CTIPRTY | JESimputprnity 
[He [30 | SMrazast [4 [binary [TCTAST | Device allocation stattime 
[#52 [a4 | smrsarrs [4 [binary [TcTPPST [Problem program start time, inhundredthe of @second 
| +66 | 38 | SMF32SIT | 4 | packed — |packed — JCTIMRSS | Step initiation time 


Rll SMF32STD ) 4 [packed PTS Step initiation date, in the form OOY YDDDF, where F 
is the sign 


SMF32RST | 4 | binary JMRENTRY Reader start time 


packed |JMREDATE Reader start date, in the form OOY YODDF, where F 

is the sign 
SMF32RET binary SMRDRSTP Time, in hundredths of a second, reader recognized the end 

of the job or started task. For TSO, this is the logon 
enqueue time. 

packed |SMRORSTP +4 Date, in the form QOY YYDDF, where F is the sign, reader 
recognized tha end of the batch job or started task. For 
TSO, it is the logon enqueue date. 


| 50 | SMF32USA | 20 |EBCDIC |ACTINFLD | Programmer name 
sees sarsor [ene aero — RACF group ID 


+116] 74 SMF32TID EBCDIC JACEEUSA_ RACE terminal 1D 
0 if RACE is not active or user is not a terminal user. 














TSO Command ee 1 and 21 





SMF32CMD EBCDIC TSO command name 


Tee srsacier [4 [binary —[ernat ——[“Narsoro¥ 750 era 


IThe subtype is indicated in offset O of the product saction. Only those commands included in CSECT | EEMB8&46 are 
used. Data for ail other commands is included in ‘***OTHER’. Only those commands that are entered at least once, 
during the session are included in the record. Invalid or unknown commands appear under ‘EXEC’. Subtypes 1 and 3 
contain data on TSO activity since the start of the session or since the last interval record was produced. Subtypes 
2 and 4 contain data on the cumulative TSO activity for the entire session. If there is no activity during an interval, no 
interval record is produced. The subtype is indicated in the SMF32TYP field. 
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orm Nene [eon] Format [sous [Cites 


TSO Command Segment-Subtypes 3 and 4 
+0 0 SMF32CMD 8 EBCDIC] internal TSO command name 


Tre [| SMFS2CNT | 4 | binary | intornet | _Number of times the TSO command was entered 
Ta2[ e | sMrsaTea [4 | binary [intern | Total TCB time forthe command 
T1610 | smFa2sRe [4 | binary | income! | Total SRB time forshecommand 
aa 14 | SMFSaTET [4 | binary [internat | Tous TGET count for the commend 
eae [16] smesaTeT [| piney [intemal | Total TPUT count forthe command 


SMF3ZTAN | 4 | binary | internal | _ Total transaction count for the command 
[732 | 20 [SMFazexP [4 | binary [intemal | Total EXGP count forthe command 


| +36] 24— SMF32TCT | 4 | binary | ASCBDCTI Total device connect time for this command 


1The subtype is indicated in offset 0 of the product section. Only those commands included in CSECT IEEMB846 are 
used. Data for all other commands is included in ‘***OTHER’. Only those commands that are entered at least once, 
during the session are included in the record. Invalid or unknown commands appear under ‘EXEC’. Subtypes 1 and 3 
contain data on TSO activity since the start of the session or since the last interval record was produced. Subtypes 
2 and 4 contain data on the cumulative TSO activity for the entire session. If there is no activity during an interval, no 
interval record is produced. The subtype is indicated in the SMF32TYP field. 
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Record Type 34 (22) — TS-Step Termination 





Record type 34 is constructed by IEFTB722 and written by IEFTB721 when the 
TSO logoff function processes a job step termination. Its length is 202 bytes plus 
(1) eight bytes for each device entry and (2) the length of the step accounting fields. 


This record identifies the job by job name, logon time and date, user identification, 
program name, and performance group number. If accounting numbers (which can 
be alphameric) were specified on the EXEC card, they are included. 


This record also contains operating information such as initiator start time, 
number of TPUTs issued, number of TGETs satisfied, termination status, device 
allocation start time, problem program start time, step CPU time, step service, and 
storage protect key. It contains the number of page-ins, page-outs, swap-ins, and 
swap-outs for both VIO and non-VIO data sets. 


Record type 34 also has an entry for each non-spooled data set that was defined 
by a DD statement. Each entry lists the device class, unit type, 
device number, and EXCP count for the data set. 
Notes: 
1. Data sets are recorded in the order of the step DD statements; they are not 
identified by name. (A user-written IEFUJV exit routine can record this order 
as each statement is validated.) 


2. For data sets that are dynamically unallocated, the data set entry information is 
in record type 40 — not in record type 34. 


3. For more information on EXCP count and CPU time, see Chapters 8 and 9, 
respectively. 





The format is: 


[ores [Nene | Lonats [Foret | Sours | 

fe fo rane | 2 ier [ent 
| 2 | TIv34seG | 2 {binary | binary |internah 

6 VS2 


2 [vans binary vera 83 
7 Reserved 


rs_[ 5 |TIVACDTY| 1 [binary [internal | _ Record type 
TIVRCDTS binary SVC 83 Time, in hundredths of a second, record is passed to the 
SMF writer. This is the time the step terminated. 
TIVRCDTE packed | SVC 83 Date, in the form OOYYDDDF where F is the sign, record 
is passed to the SMF writer. This is the date the step 
terminated. 


14] E | TIVCPUID 4 | EBCDIC| JMACPUID System identification (taken from SID parameter) 
ne_[12 [rive | @ | e@coI¢ | wos 


| 26 | 1A |TIVONTME| 4 {binary | JMRENTRY Logon time, in hundredths of a second 
| 30 | 1E |TIVONDTE| 4 — |packed | JMREDATE Logon date, in the form OOYYDDDF where F is the sign 


a TIVUDATA a EBCDIC | JMRUSEID User identification (taken from common exit parameter 
area) 


| 42 | 2A- TIVINVSQ | 4 [binary — LCTSNUMB Step number. (This field always equals 1.) 


| 2a TIVSIT | 4 [Piney JCTJMRSS (Set by Time, in hundredths of a second, initiator selected this step 
JEFSMFIE) 


(Continued) 











Description 







Record length 










Segment descriptor 






System indicator 
Bit Meaning When Sat 
0-4 Reserved 
5 MVS/XA 
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[oft [Name [Leng [ Former [Sores [SC ion 


47 TIVOUTCT binary TCTLOUT Number of lines of terminal output, that is, number of 
TPUTs issued 
TIVINCT binary TCTLIN Number of lines of terminal input, that is, number of 
TGETs satisfied 


37 TIVSTAT binary TCBCMPC Step completion code: 
X‘Occc’ indicates system ABEND where code is the 
system ABEND code. (See System Codes.) 
X‘'8ccc’ indicates user ABEND where ccc is the user 
ABEND code. 
X‘nnnn’ indicates normal completion where nnn is the 
contents of the two low-order bytes in register 15 at 
termination. 
X ‘0000’ indicates either (1) the job step was flushed (not 
executed) because of an error during allocation, or (2) 
normal job completion with a return code of 0. 
Use this field in conjunction iwth the step-termination 
indicator field (offset 87). 


57 TIVPRI binary SCTSDPTY Address space dispatching priority (taken from DPRT Y= 
parameter on EXEC card or the APG value in CVTAPG).! 
ate TIVPRGNM i EBCDIC | SCTPGMNM Program name (taken from PGM= parameter on EXEC 





























card). If a backward reference was used (SCTSTYPE 
head TIVINVNM | 8 | EBCDIC | SCTSNAME Step name (taken from name on EXEC card) 
area, in 1K units. This storage area includes subpool 
field equals the amount of contiguous real storage 
above 16 megabytes, and this field will contain a 
Tif the dispatching priority falls within the APG range, the actual execution dispatching priority will be assigned based on the 


equals X‘80’), then this field contains *.DD. 
TIVRSV5 binary Reserved. Note that TIVEFRGN, formerly a two-byte 
field at this offset, has been increased to four bytes and 
76 4C | TIVSYST binary TCTHWM/1024 Largest amount of storage used from top of private area, 
in 1K units. This storage area includes the LSQA and 
SWA (subpools 229, 230, 236, 237 and 253-255). If 
ADDRSPC=REAL is specified, this field equals the 
amount of storage used that was not from the contiguous 
real storage reserved for the program. See offsets 82 and 
102.1 
0-127, 251 and 252. If ADDRSPC=REAL is specified, 
this field equals the amount of contiguous real storage 
TIVEFRGN boii a Region size established, in 1K units taken from the 
REGION= parameter in the JCL, and rounded up to a 
reserved for the program. If the region requested was 
greater than 16 megabytes, the region established resides 
minimum value of 32 megabytes. 
TIVSPK binary TCBPKF Storage protect key, in the form xxxx0000 where xxxx 
is the key 
Installation Performance Specification (IPS). If the dispatching priority is controlled via the IPS, it may periodically change based 
upon characteristics. If the dispatching priority is not in the APG range, the value in field TIVPRI will be the actual execution 


moved to offset 82. 
78 TIVMCRE binary TCT LWM/1024 Largest amount of storage used from bottom of private 
that was used. See offsets 82 and 102.2 
four K boundary. If ADDRSPC=REAL is specified, this 
(Continued) 
dispatching priority. For more information, see /nitialization and Tuning. 


2if storage was not allocated (job step was flushed), these fields equal zero. 
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TIVSTI binary Step termination indicator 
Bit Meaning When Set 
0-1 Reserved 

JCTJMRCL Canceled by exit IEFUJIS 

JCTJMRCL Canceled by exit lEFUSI? 

JCTJMRCL Reserved 

JCTSTEPR Step is to be restarted 
If 0, normal completion. 

TCBFA If 1, ABEND. If step completion code (offset 55) 
equals 0322 or 0522, IEFUTL caused ABEND. 
lf step completion code equals 0722, |IEFUSO 
caused ABEND. 

TCTHWM If 0, normal completion. 

If 1, step was flushed. 


rae [ sa | tivavi[ 2 [binary | ~*~ 


5A TIVAST binary | TCTAST (Set by Device allocation start time, in hundredths of a second 
lEFBB401) 

TIVPPST binary | TCTPPST (Set by Problem program start time, in hundredths of a second 
(EFABS20) 


p98 | 62 | TivAV2 | 1 [binary | | Reserved 


TIVSRBT binary | SCTSRBT Step CPU time under SRBs, in hundredths of a second. 
This field Includes the CPU time for various supervisory 
routines that are dispatched via SRBs: locking routines, 
page resolutdon, swap control, cross-memory communica- 
tions (WAIT, POST, I/O POST), and TQE scheduling.“ 

TIVRIN binary Record indicator 
Bit Meaning When Set 

Reserved 
TCTIEX EXCP count may be wrong 3 
SCTSSTAT if 0, storage is virtual. 
If 1, storage is real. 
- Reserved 


TIVRLCT binary | internal Offset from the beginning of the racord header to the 
relocate section 
6A TIVVAR binary | internal Length of device entry portion of record. Calculated as: 
(8 times the number of devices) + 2 


For each device assigned to each non-spooled data set, there is an eight-byte entry with the following format: ® 











+0 | O TIVDEVC 1 binary | UCBTBYT3 Device class 

+1] 4 TIVUTYP 1 binary | UCBTBYT4 Unit type 

+2 | 2 TIVCUAD | 2° |binary | UCBCHAN Device number 

+4 | 4 TIVNEXCP 4 binary | TCTDCTR EXCP count (sea offset 102)5 


(Continued) 

3Job steps canceled by IEFUJI and IEFUSI will not be executed; therefore bit 7 will also be on. 

4 CPU time is not expected to be constant between different runs of the same job step. For more information 
on CPU time, see Chapter 9. 


> Ifa GETMAIN for expanding the TCTIOT (the data area where EXCPs are maintained) fails, only the existing 
data sets are counted. If the functional recovery routine is entered, EXCP counting for the step is discontinued 
and no device entries are produced. !f ADDRSPC=REAL Is specified, the EXCP count does not include PCls. 
For more information on EXCP count, see Chapter 8. 


Gentries for DD*, DD DATA, DD DUMMY and spooled data sets are zero. (A DD DUMMY 
entry results when a forward reference to a DD statement having that DD name is not found 
or when DD DUMMY is specified.) Entries for VIO data sets are zero for class and type, 
X'7 FFF’ for device number. When the high order bit in the device number field is on, it 
indicates a virtual device. 
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address space was swapped out. It does not include 
page reclaims nor pages found in storage during the 
swap-in process (such as pages brought in via SRB’s 
started after completion of swap-in Stage 1 















Offsets | Name [Length | Format | Source | Description 
After the device entries are the following fields: 
BEE Section: 
TIVVARA | 4 | binary [internal Length of accounting section, excluding this field. 
TIVCPUTM binary | ACTJTIME Step CPU time under TCBs, in hundredths of a 
second. This field includes the CPU time for all tasks 
that are dispatched via TCBs below the level of RCT.* 
Ee TIVNBRAC | 1 | binary [internal |_ Number of accounting fields. 
+5 TIVACFLD | variable EXEC statement Accounting fields. Each entry for an accounting field 
contains the length of the field (one byte, binary) 
followed by the field (EBCDIC). A zero indicates 
an omitted field. 
Relocate Section: 
TIVPGIN? binary | OUXBPIN Number of non-V1IO, non-swap page-ins for this step. 
This field includes page-ins required through page 
faults, specific page requests, and page fixes. It does 
not include page reclaims, page-ins for VIO data sets, 
pages that are swapped in, and page-ins for the 
common area. 
+4 +4 TIVPGOUT binary |OUXBPOUT Number of non-V1O, non-swap page-outs for this step. 
This field includes page-outs required through specific 
Page requests as well as those pages stolen by the 
Paging supervisor as a result of infrequent use. It does 
not include page-outs for VIO data sets, pages that are 
swapped out, and page-outs for the common area. 
+8 +8 TIVRGNS binary |OUXBSWCT Number of address space swap sequences. (A swap 
sequence consists of a physical swap-Out and swap-in 
of an address space. Logical swap-out and swap-in are 
not included). 
+12 | +C TIVSIN binary | OUXBSPIN Number of pages swapped in. This field includes: 
LSQA, fixed pages, and those pages that the real 
storage manager determined to be active when the 
processing). 
+16 | +10 TIVSOUT binary | OUXBSPOT Number of pages swapped out. This field includes: 
LSQA, private area fixed pages, and private area non- 
fixed changed pages. 
+20 | +14 TIVVPI binary |OUXBVAMI Number of VIO page-ins for this step. This field 
includes page-ins resulting from page faults or specific 
page requests on a VIO window. It does not include 
VIO swap-ins or page-ins for the common area. 
+24 | +18 TIVVPO binary | OUXBVAMO Number of VIO page-outs for this step. This field 
includes page-outs resulting from specific page 
requests on a VIO window, as well as those pages 
stolen by the paging supervisor as a result of 
infrequent use. It does not include VIO swap-outs or 
page-outs for the common area. 
+28 |+1C | TIVSST binary | OUXBJBS + Step service, in service units” 
OUXBTRS 
lea! +20 TIVACT binary | OUXBJBT + Step gransaction active time, in 1024-microsecond 
OUXBTRT units 
lel +24 TIVPGNO binary | OUCBNPG Step performance group number (taken from PERFORM= 
parameter on JOB or EXEC card or the RESET operator 
command).® 





(continued) 


4CPU time is not expected to be constant between different runs of the same job step. For more information on 
CPU time, see Chapter 9. 


7The displacement of this field depends upon the size of the accounting fields and the number of devices. 
Offset 104 contains the displacement for this field. 


8 : , ; 
For more information on service, transaction active time, and performance group number, 


see /nitialization and Tuning. 
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Lotter | Name [Length] Format | souree | Darnton 


+38 TIVTRANT OUXBJBR + Step transaction residency time, in 1024-microsecond 
OUXBTRR 


units. That is the amount of time the transaction was in 
real storage. 

TIVRECLM | 4 | binary | OUXBPREC Number of reclaims for this step 

}+#46 | 2€ | TIVRCLAM| 4 | binary | OUXBVAMR Number of VIO reclaims for this step 


TIVCPGIN OUXBCAPI Number of common area page-ins for this step 
(LPA + CSA) 

TIVCRECL OUXBCAPR Number of common area reciaims for this step 
(LPA + CSA) 


+58 | 3A | TIVPGSTL | 4 | binary | Number of pages stolen from the storage for this step =| | Number of pages stolen from the storage for this step =| from the storage for this step 


a TIVPGSEC il lll OUCBPSS Number of page seconds for this step, in page millisecond 


units. Calculated as: the number of pages used by this 

nb times the execution time it held that number of 
/+70/ 46 | TivLPAl | 4 | binary | OUXBLPAI Number of link pack area page-ins for the step 
TIVLPAR | 4 | binary | OUXBLPAR Number of link pack area reclaims for the step 


+78 TIVCPUS binary | OUXBJCPU + Step CPU service, in service units® 
OUXBTCPU 
TIVIOCS OUXBJIOC + Step I/O service, in service units® 
OUXBTIOC 
+86 TIVMSOS OUXBJMSO + Step main storage service, in service units® 
OUXBTMSO 
5A TIVSRBS OUXBJSRB + Step SRB service, in service units® 
OUXBTSRB 


SE or more information on service, transaction active time, and performance group number, 
see /nitialization and Tuning. 
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Record Type 35 (23) — LOGOFF 


Record type 35 is constructed by IEFTB722 and written by IEFTB721 when a 
logoff process is completed. Its length is 137 bytes plus the length of the job 
accounting fields. 

This record identifies the job by job name, logoff time and date, logon time and 
date, user identification, and performance group number. If accounting numbers 
(which can be alphameric) were specified on the JOB card, they are included. 


This record also contains operating information such as number of TPUTs issued, 
number of TGETs satisfied, termination status, storage protect key, job service, 
transaction active time, number of transactions, and job CPU time. 


Notes: 
1. For more information on CPU time, see Chapter 9. 


2. If the terminal I/O controller (TIOC) does not attempt to send output (for 
example, a message) to a terminal whose line has been disconnected, it will 
not detect a line disconnect. To SMF, a terminal session interrupted by a 
line disconnect is considered to be executing and a type 35 record will not 
be issued until: 


e The disconnect situation is detected, the reconnect time limit expires, 
and the system cancels the session (with a completion code of 622); or 


e The disconnect situation is detected, the user reconnects, and sub- 
sequently issues a LOGOFF command. 


The format is: 


ona [Nave [usveth[ Format [Sow [SSCs 
CN 
(2 | 2 | TuG3ssec | 2 [binary | internal | Segmentdescriptor Cd 


TLGRFELG binary SVC 83 System indicator 
an Meaning When Set 
Reserved 
MVS/XA 
VS2 
Reserved 


s [8 | Tucreoty | 1 [binery |intemar | Record type 
6 TLGRCDTS binary SVC 83 Time, in hundredths of a second, record is passed 
to the SMF writer. This is the logoff time. 
10 TLGRCDTE packed | SVC 83 Date, in the form OOY YDODF where F is the sign, 
record is passed to the SMF writer. This is the logoff date. 
14] € | TuGcPuID | 4 | EBCDIC|JMRCPUID | System identification (taken from SID parameter) 
-1@ | 12 | TLUGUIF | 8 | EBCDIC| JMRJOB Job name 


| 26 | 1A | TLGONTME| 4 _ [binary |JMRENTRY | Logon time, in hundredths of a second 
| 30 | 1E | TLGONDTE | 4 = | packed | JMREDATE Logon date, in the form OOY YDDDF where F is the sign 


“|= TLGUDATA a EBCDIC| JMRUSEID User identification (taken from common exit parameter 
area) 


| 42 | 24] TLGsTPcT | 1 |binary | JMRSTEP Number of steps in session. (This field always equals 1.) 
ras | 26 | TuGcRTME| 4 [binary | —*d|~iReeed 


47 TLGOUTCT binary | TCTLOUT Number of lines of terminal output, that is, number of 
TPUTs issued 
TLGINCT binary | TCTLIN Number of lines of terminal input, that is, number of 
TGETs satisfied 


(Continued) 
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[Offs [Neme [Usnath [Format [Source [7 Oeweriptlon 
binary 


37 TLGSTAT 2 i TCBCMPC Job completion code: 
X’Occc’ indicates system ABEND where ccc is the system 
(See Message Library: System Codes.) 
X'8ccc’ indicates user ABEND where ccc is the user 
ABEND code. 
X‘nnnn’ indicates norme| completion where nnnn is the 
contents of the two low-order bytes in register 15 at 
termination. 
X’0000’ indicates normai job completion with return 
code of 0. 
Use this field in conjunction with the job termination 
Indicator field (offset 66). 


TLGPRI binary JCTJPRTY Logon priority. This field normally equals the user-assigned 
priority of 0-13, but if the job fails while being scheduled, 
this field equals 14 (taken from the PRTY parameter on 
the JOB card)* 


TLGNQTME | 4  |binary | JMRDRSTP | Logon enqueue time, in hundredths of a sacond 
TLGNQDTE | 4 | packed JMRDORSTP +4 | Logon enqueue date, in the form OOY YODDF where F 
is the sign 


TLGTRMI binary Job termination indicator 

Bit Meaning When Set 
0-1 Reserved 

JCTJMRCL 2 ‘Canceled at exit IEFUJI 

JCTIMACL 3. Canceled at exit /EFUS! 
4-5 Reserved 
6 If O, normal completion. If 1, abnormal 

termination 

7 Reserved 


fe7_|_a3_[TuGouTCL | —1_|binay | —S—S~sd Reserved ——SOSOSSSSSSSSTCCC 


TLGTRANT binary OUXBJBR + Job transaction residency time, in 1024-microsecond units. 
OUXBTRR That is the total amount of time all transactions were in 
real storage. 


7z_[ as [TuGAVG [4 _[oinay | ——S~S~s Reserved OSSOSOSSSCSCSCSCSC“‘“SC*~S™S 


TLGSPK pt [binary gee eee Rn TOS VE WS protect key, in the form xxxx0000 where xxxx 
is the key 


77 TLGSRBT binary SCTSRBT Job CPU time under SRBs, in hundredths of a second. This 
field includes the CPU time for various supervisory routines 
that are dispatched via SAB: locking routines, page resolu- 
tion, swap control, cross-memory communications (WAIT, 
POST, I/O POST), and TQE scheduling.? 


TLGTJS binary | OUXBJBS + Job service, in service units 
OUXBTRS 
84 | 54 TLGTTAT 4 binary  OUxBJBT + Job transaction active time, in 1024-microsecond units 




















| OUxeter 


}a8 | 58 TLGNTSN | 4 | binary — OUXBTRC Number of transactions 


(Continued) 


Topy time may not be constant between different runs of the same job. For more information on CPU time, see Chapter 9. 
For more information on service, transaction active time, and performance group number, see /nitialization and Tuning. 
Note that the service, active time, and residency time may have been accumulated under different performance group 
numbers. 
31f no value is specified for the PRT Y parameter on the JOB card, this field contains: 
e For JES3, the default priority specified on thea JES3 STANDARDS initialization card 
e For JES2, a zero. 
Note that JES2 does nor use the priority value reported in this field. (The JES2 job selection priority is requested via the 
JES2 PRIORITY control statement.) 
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[ofies [Nave [lath [rormet [Sows [Con 


TLGPGNO binary | OUCBNPG Performance group number (taken from PERFORM= 
parameter on JOB card or from a RESET or SET IPS 
command)? 

94 [se | TLGRV2 | 2 | binary | 


a TLGVAR AES —— Length of rast of record, excluding this field 


1 a 75 TLGCPUTM EBoDIE ACTJTIME Job CPU time under TCBs, in hundredths of a second. This 
field inclues the CPU time for all tasks that are dispatched 
via TCBs below the level of RCT.2 

120) 78 TLGNBRAC pt [binary ACTJNFLD Number of accounting fields 


793 TLGACELD | variable JOB statement Accounting fields. Each entry far an accounting field 
contains the length of the field (one byte, binary) 
followed by the field (EBCDIC). A zero indicates an 
omitted field. 

Relocate Section: 
TLGCPUS binary | OUXBJCPU + Job CPU service, in service units” 
OUXBTCPU 


=p TLGIOCS | 4 | binary OUXBJIOC + Job 1/O service, in service units“ 
OUXBTIOC 


+8 TLGMSOS binary | OUXBJMSO + Job main storage service, in service units@ 
OUXBTMSO 

42] 12 | TLGSRES binary | OUXBJSRB + Job SRB service, in service units” 
OUXBTSRB 


epu time may not be constant between different runs of the same job. For more information on CPU time, see Chapter 9. 





zor more information on service, transaction active time, and performance group number, see /nitialization and Tuning. 


Note that the service, active time, and residency time may have been accumulated under different performance group 
numbers. 
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Record Type 37 (25) - Network Problems Determination Application ) 


Record type 37 is written by NCCF whenever the NPDA REPORTS option is invoked 
and each time an NPDA input record passes the NPDA recording filters. 


This record contains event and/or statistical data. It includes information on resource 
names and types (common data section), error description and probable cause (events 
section), traffic information (statistical data section), and modem data (modem data 
section and LPDA-2 data section), and local area network data (LAN data section). All 
unused fields in record-type 37 are set to hexadecimal zeroes. 


Notes 
NPDA does not create a report record for the following: 


@ RECFMS 01, 02, 03 (counter sets 1, 2, and 4), 05, and 06 
@ solicited Network Management Vector Transport 0025 (NMVT) records 


@ arecord that results from intensive mode recording 
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( The format is: 
(ares Tee ow [rene [eee [os 


BRFRLEN 
BRFRSEG 
BRFRFLG 


BRFRRTY 
BRFRTME 


BRFRDTE 


BRFRSID 
BRFRWID 


BRFRSUBT 


BRFRPRODI 
BRFRPROLN 
BRFRPRONO 
BRFALLDI 
BRFALLLN 
BRFALLNO 
BRFEVTDI 
BRFEVLN 
BRFEVNO 
BRFSTADI 
BRFSTALN 
BRFSTANO 
BRFMODDI 
BRFMODLN 
BRFCMODNO 
BRFLPDDI 
BRFLPDLN 
BRFLPDNO 
BRFLANDI 
BRFLANLN 
BRFLANNO 


NN &2& NY NY 2 NY NH A NY NY A DH NY A NY NY AB NY NY A 


binary 
binary 
binary 


binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


binary 


binary 
binary 
binary 
binary 
binary 


binary 


internal 
inter nal 


SVC 83 


internal 


SVC 83 


SVC 83 


SMCASID 


internal 


internal 


internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 


internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 





Record length 
Segment dascriptor 
System indicator 


Bit Meaning When Set 

0 Standard identification follows system identification 
14 Reserved 

5 MVS/XA 

6 VS2 

7 Reserved 


Record type 37 (X'25') 


Time, in hundredths of a second, record was moved to SMF 
buffer 


Data record was moved to SMF buffer, in the form 
OOyydddF, where F is the sign 


System identification (taken from SID parameter) 
Subsystem identification (‘NCCF’) 
Record subtype 


(‘01° — NPDA V3R2) 
('02' — NPDA V3R3) 


Offset to product section 

Product saction length 

Number of product sections (0 or 1) 
Offset to common data sections 

Common data section length 

Number of common data sections (0 or 1) 
Offset to event section 

Event section length 

Number of event sections (0 or 1) 


Offset to statistics section 
Statistics section length 


Number of statistics sections (O or 1) 
Offset to modem section 


Modem section length 


Number of modem sections (0 or 1) 
Offsec to LPDA-2 section 

LPDA-2 section length 

Number of LPDA-2 sections (0, 1, or 2) 
Offset to LAN section 

LAN section length 

Number of LAN sections (0 or 1) 
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Product Section: 


BRFSUBTY 


BRFREVLT 
BRFPRONM 


BRFTIMST 


Common data section: 


Event Section: 


BRFDOMNM 
BRFLRNM 
BRFLRTY 
BRFHINM1 
BRFHITY1 
BRFHINM2 
BRFHITY2 
BRFHINM3 
BRFHITY3 
BRFHINM4 
BRFHITY4 
BRFHINMS 
BRFHITYS 
BRFCPL 


BRFALT 


BRFALRTT 
BRFGENCA 
BRFSPECA 
BRFBLKID 
BRFUACD 
BRFUAQL1 
BRFUAQL2 
BRFUAQL3 
BRF48TXT 
BRFDBKID 
BRFDUACD 
BRFNMVTY 


> © b&b ODO Fb DO fF DO fF ODO F&F DO DW 


oh 


binary 
EBCDIC 


packed 


EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
binary 


binary 
binary 
binary 
binary 
binary 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
binary 
binary 
binary 
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internal 


internal 


internal 


inter nal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
inter nal 
internal 
internal 
internal 
internal 


internal 


internal 


internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 


Record subtype 
(‘01' — NPDA V3R2) 
(‘02‘ — NPDA V3R3) 


NPDA release level! 
Product name: ‘NPDA‘ 


Time and date in the form 00 Y YODDFHHMMSSOF where 
F is the sign 


Domain name 

Failing resource name 
Failing resource type 
Resource level 1 name 
Resource level 1 type 
Resource level 2 name 
Resource level 2 type 
Resource level 3 name 
Resource level 3 type 
Resource level 4 name 
Resource level 4 type 
Resource level 5 name 
Resource level 5 type 
Complex link indicator 
x'00’ no 

x'01' yes 

Alert indicator 

x'00’ no 

x'01’ yes 


Alert type for event record 
General cause for event record 
Specific cause for event record 
Block identification 

Action code 


Detail qualifier 1 


Detail qualifier 2 


Detail qualifier 3 

Error description: probable cause 
Detail Block id 

Detail Action code 


0O=NMVT 0000 
01=NMVT 0001 
O2=NMVT 0025 
OF=MISC. NMVT 
FF=NON NMVT 








ae es 


Statistics section: 





BRFTRFFC binary 
BRFTEMPS binary 
Modem Section: 
+0 +0 BRFFAIL 1 binary 
+ +1 BRFLNKTY 1 binary 
+2 +2 BRFLMSIN 1 binary 
+3 +3 BRFRMSIN 1 binary 
+4 +4 BRFMODOD EBCDIC 
+6 +6 BRFMODTP EBCDIC 
+12 +C BRFMODSP EBCDIC 
bd 416 | +10 | BRFLNQUL binary 
+18 +12 | BRFHTCTL binary 
+20 +14 | BRFLDBIN 2 binary 
+22 +16 | BRFLDBNO 2 binary 


internal 


internal 


internal 


internal 


internal 


internal 


internal 


internal 


internal 
internal 


internal 


internal 


internal 


Total traffic 





Total temporary errors 


Failure indicator 


X'00' Not applicable 

X'01' Modem probe 

X'02' Line 

X'03' Remote device 

X'04' Communications (if unknown) 
X'05’ Modem interface 

Type of link 

X'01' BSC 

X'01' SDLC 

Local modem status indicator - includes modem speed 
X‘'00' invalid 

X'01' valid 


Remote modem status indicator 


X’00' 
X'01' 


invalid 
valid 


Modem address 


Modem type. This field contains either the machine 
number or N/AV (not available). 


Data rate (full or half) 


Local modem line quality (0-15) 


Local modem line hits (0-63). This field is model 
dependent. See relevant pubs for your modem model. 


This field indicates whether the Receive Level in DBm for 
the loca) modem is within measurable Jimits. 


Value Meaning 

X'0000' Not applicable 

X‘0001' Receive Level is greater than the maximum 
measurable value (-4) as shown in BRF LDBNO 

X‘0002' Receive Level is less than the minimum 
measurable value (-48) as shown in BRFLDBNO 

X'0003' Receive Level is within measurable limits as 


shown in BRFLDBNO 


Receive Level in DBm for the local modem (signed 


decimal) 
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Modem Section: (continued) 
BRFLNQURA 
+1A | BRFHTCTR 


binery 
binary 


BRFRDBIN 


binary 


BRFRDBNO 





LPDA-2 Section: 


+0 +0 BRFFAIND binary 
+1 +1 BRFLINK binary 
+2 +2 BRFSENSE binary 
+3 +3 BRFLSL binary 
+4 +4 BRFADDR EBCDIC 
+6 +6 BRFTYPE EBCDIC 
+10 +A BRFMODEL EBCDIC 


+12 +C ° 


+14 +E BRFLOCAL 


+36 +24 | BRFRMT binary 
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internel 


internal 


internal 


internal 


internal 


internal 


internal 
internal 
internal 


internal 


internal 


internal 


internal 


Remote modem line quality (0-15) 


Remote modem line hits (0-63). This field is model 
dependent. See relevant pubs for your modem model. 


This field indicates whether the Receive Leve! in DBm for 
the remote modem is within measurable limits. 


Velue Meaning 


X’0000’ Not applicable 

X'0001’ Receive Level is greater than the maximum 
measurable value (-4) as shown in BRFRDBNO 

X'0002’ Receive Level is less than the minimum 
measurable value (-48) as shwon in BRFRDBNO 

X'0003’ Receive Level is within measurable limits as 
shown in BRFRDBNO 


Receive Level in DBm for the remote modem (signed 
decimal) 


Failure indicator 
X‘00' Not appliable 
X‘01' Modem/probe 
X‘Q2’ Line 
X'03' Remote device 
X'04' Communications (if unknown) 
X‘05' Modem interface 


Type of link 

X'01’ BSC 
X‘02’ SDLC 
Modem Sense Byte 
Link Segment Level 


Modem address 


Modem type. This field contains the four digit machine 
number. 


Modem model. This field contains the two digit modem 
model. 


Reserved, 


Local Modem Report 
This field ig overlayed by the section entitled LOCAL 
AND REMOTE MODEM REPORTS. 


Remote Modem Report 
This field is overlayed by the section entitled LOCAL 
AND REMOTE MODEM REPORTS 














c 


Local and Remote Modem Reports: 


+0 
+2 
+4 
+6 
+8 
+10 
+16 
+18 


+19 


+20 


+21 


Loca! Area Network Section: 





+0 
+2 
+4 
+6 
+8 
+A 
+10 
+12 


+13 


+14 


+15 


BRFLO 
BRFWLO 
BRFIMP 
BRFRDBM 
BRFMRDBM 
BRFSPEED 
BRFACTSP 
BRFNETFU 


BRFFEAIN 


BRFFEAER 


BRFLMADR 
BRFRMADR 


BRFROUTI 
BRFUPADR 
BRFDNADR 


>a @©@ NHN N NN AN WN 


o_o 


binary 
binary 
binary 
EBCDIC 
EBCDIC 
EBCDIC 
binary 
EBCDIC 


binary 


binary 


EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 


internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 


internal 


internal 


internal 
internal 
internal 
internal 


internal 





j_oftete [Name | tenatn | Format | source | Deserotiom 


Line Quality (0-15) 
Worst Line Quality (0-15) 
Impulse Hit Count 


Receive Level in DBm 


Minimum Receive Level in DBm during last 15 minutes 


Modem Speed (‘FULL ’ or ‘BACKUP’) 
Actual Modem Speed in bits per second 


Network Function 
’01'X = PRIMARY, 
‘02'X = SECONDARY, 
'03'X = CONTROL, 
°04’X = TRIBUTARY 


Features Installed 
BIT O — Reserved 
BIT 1 — Reserved 
BIT 2 — Reserved 
BIT 3 ~ Fan Out Installed 
BIT 4 — Reserved 
BIT 5 — Reserved 
BIT 6 — Reserved 
BIT 7 — Reserved 


Features in Error 
BIT 0 — Reserved 
BIT 1 — Reserved 
BIT 2 — Reserved 
BIT 3 — Fan Out in Error 
BIT 4 — Reserved 
BIT 5 ~ Modem in ldle State 
BIT 6 — Non Vital Data Lost 
BIT 7 — Base Modem Error 


Reserved 


Local MAC Address 

Remote MAC Address 

Routing Information 

MAC Address of Upstream Member 
MAC Address of Downstream Member 
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Record Type 38 (26) — Network Performance Monitor Statistics 





Record type 38 is written by Network Performance Monitor (NPM) at user 
specified intervals and contains network statistics. For more information about 
the type 38 record, refer to Network Performance Monitor Problem 
Determination Guide (SH20-6363). 
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( Record Type 39 (27) — NLDM Response Time 


Record type 39 is written by the Network Logical Data Manager (NLDM). NLDM writes to the 
external log if the Response Time Data function (RTM) or the Network Accounting and 
Availability Measurement function is active. 


The Response Time Data function writes record type 39 when the COLLECT command with the 
LOG parameter is issued or at session end for an LU attached to a 3274 controller with the RTM 
feature. 


The Network Accounting and Availability Measurement Data function writes record type 39 when 
a session is started, a session ends, or when a RECORD command with the SESSTATS parameter is 
issued, 


The format is: 


[ores [name [wn Fonee [Smee [artes 


LOGRLENG binary internal Record length 


LOGRSEGD binary interna! Segment descriptor 


LOGRSYSI binary SVC 83 System indicator 


Bit Meaning When Set 
0-4 Reserved 
MVS/XA 
VS2 
VS1 


LOGRRECT binary internal Record type (X‘27’) 


a LOGRTIME EBCDIC | SVC 83 Time, in hundredth of a second, record was moved to 
external log buffer. 


LOGRDATE EBCDIC | SVC83 Date record was moved to external log buffer, in the 
form OOYYDDDF where F is the sign. 


LOGRSYID EBCDIC | SMCASID System identification (taken from SID parameter) 
LOGRSUBS 4 EBCDIC | internal Subsystem ID ‘NCCF’ 
LOGRSUBT 2 binary internal Record subtype 


1 = COLLECT RTM LOG 

2 = Session end 

3 = Session start 

4 = Accounting and availability data 
5 = Combined 

6 = Bind failure 
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ore [aie [een rome [Soe Oa 


Data Descriptor Section: 


LHRDRPRDO 
LHDRPRDL 
LHDRPRDN 
LHDRSESO 
LHDRSESL 
LHDRSESN 
LHDRRTEO 
LHDRRTEL 
LHDRRTEN 
LHDRRTMO 
LHDRRTML 
LHDRRTMN 
LHDRACCO 
LHDRACCL 
LHDRACCN 


4 
2 
2 
4 
2 
2 
4 
2 
2 
4 
2 
2 
4 
2 
2 


binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


binary 


BINARY 
BINARY 


internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 





Offset of product section 
Length of product section 

Number of product sections 

Offset of session configuration section 

Length of session configuration section 

Number of session configuration sections 

Offset of route data section 

Length of route data section 

Number of route data sections 

Offset of response-time data section 

Length of response-time data section 

Number of resonse-time data sections 

Offset of accounting and availability data sections 
Length of accounting and availability data sections 


Number of accounting and availability data sections 





Note: The offset fields of this section are the offsets of the data areas from the beginning of log record. 
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a 


Product Section: 


LPRDSUBT binary internal Record subtype 


1 = COLLECT RTM LOG 

2 = Session end 

3 = Session start 

4 = Accounting and availability data 
5 = Combined 

6 = Bind failure 


LPRDVERN EBCDIC | internal Product version and release 
(‘F1F2’ — VIR2) 
(‘F1F3’ — VIR3) 


LPRDNAME EBCDIC | internal Product name — ‘“‘NLDM” 





Note: LPRDSUBT is the same as LOGRRECT in Log Record Header Section. 
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Session Configuration Data Section: 

+0 0 LSESREVL 2 binary VTAM Revision level: NLDMVIR2 = 1 
NLDNVIR3 2 

EBCDIC | VTAM Primary logical unit (PLU) name 

EBCDIC | VTAM Primary physical unit (PU) name 

EBCDIC | VTAM Primary link name 

EBCDIC | VTAM PLU subarea physical unit (PU) 

EBCDIC | internal PLU domain name 

EBCDIC | VTAM Secondary logical unit (SLU) name 

EBCDIC | VTAM Physical unit (PU) name for SLU 

EBCDIC | VTAM Name of the link for the SLU 

EBCDIC | VTAM SLU subarea PU 

EBCDIC | internal SLU domain name 


LSESPNAM 
LSESPPUN 
LSESPLNK 
LSESPSAP 
LSESPDOM 
LSESSNAM 
LSESSPUN 
LSESSLNK 
LSESSSAP 
LESSSDOM 
LSESPCLS 
LSESCOST 
LSESERN 
LSESRERN 
LSESVRN 
LSESTPF 
LSESPCID 
LSESTYPE 


EBCDIC | internal Performance class name 
EBCDIC | VTAM Class of service 

binary VTAM Explicit route number 

binary VTAM Reverse explicit route number 
binary VTAM Virtual route number 

binary VTAM TransMission priority 

binary VTAM Unique session ID (PCIDARSI) 


EBCDIC | VTAM Session type 
1 = LU-LU 
2 = SSCP-LU 
3 = SSCP-PU 
4 = SSCP-SSCP 


LSESXNET EBCDIC Cross network session (Y or N) 
LSESCODE binary bind failure or unbind reason code 


8 
8 
8 
8 
8 
8 
8 
8 
8 
8 
8 
8 
2 
2 
2 
2 
8 


o_o 





Note: If data is not available LSESPPUN, LSESPLNK, and LSESPSAP contain ‘00’x. If data is not available 
LSESERN, LSESRERN, LSESVRN and LSESTPFE contain ‘FF’X. 
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Sa 


Route Data Section: 


+0 0 
+2 2 
+4 4 
+6 6 


For each route element, there is a 


+0 0 
+8 8 


Response Time Data Section: 


LRTEREVL 

LRTENUME 
LRTENUMT 
LRTEETAB| 


LRTEENAM 
LRTEETGO 


LRTMREVL 
LRTMCOLB 
LRTMCOLE* 
LRTMOBJP 
LRTMOBJB 
LRTMDEF 
LRTMOBJF 
LRTMTRAN 
LRTMTOTT® 
LRTMBNDS 


2 


LRTMBKTS® 


LRTMOBJT 


2 
2 
2 
0 


binary 
binary 
binary 


internal 
interna] 
internal 


Route test 


Revision level: 4 
Number of route elements 
Number of route elements in table. 


Route element table 


ten-byte entry with the following format: 


8 


binary 
binary 


binary 
binary 
binary 
binary 
binary 
EBCDIC 
EBCDIC 
binary 
binary 
binary 


binary 


binary 


internal 


Route test 


internal 
interna! 
internal 
internal 
internal 
internal 


internal 


RTM Feature’ 
RTM Feature? 


internal 


RTM Feature 4 


internal 





Route element name 


Transmission group (out) number 





Revision level: 1 

Collection period begin time stamp 
Collection period end time stamp 
Objective — percentage 

Objective — counter number 
Response time definition 
Objective — Y=met Ne=not met 
Number of transactions measured 
Total response delay 


Four fourbyte fields containing counter 
boundaries 


Five four-byte fields with contents of 
counters 


Objective — response time 


' RTEETAB is an array of structures. LRTEENAM and LRTEETGO are fields in the structure. 


2 


For LRTMCOLB and LRTMCOLE, the first four bytes of time stamp are the local time in STCK format, the last four are the 


local time in STCK format, the last four are the conversion factor from GMT to local time. (Example: 98285412 FFFFCAS5B). 
3LRTMBKTS and LRTMTOTT are in tenth-of-seconds. 
4 The data is allocated by the RTM Feature of the PU. 
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Coe [vee [eee [oe [we 


Accounting and Availability Data Section: 


+0 0 LACCREVL 
+4 4 LACCBEGT 
+12 C | LACCENDT 
+20 14 | LACCPCBC 
+24 18 | LACCPCCC 
+28 1¢C | LACCSCBC 
+32 20 | LACCSCCC 
+36 24 | LACCPTBC 
+40 28 | LACCPTCC 

2C | LACCSTBC 
+48 30 | LACCSTCC 


binary internal Revision level: 2 

binary interna] Collection period begin time stamp 

binary internal Collection period end time stamp 

binary internal Number of control PIUs sent from primary to secondary 
binary internal Number of control bytes sent from primary to secondary 
binary internal Number of control PIUs sent from secondary to primary 
binary internal Number of control bytes sent from secondary to primary 
binary internal Number of text PIUs sent from primary to secondary 
binary internal Number of text bytes sent from primary to secondary 


binary internal Number of text PIUs sent from secondary to primary 


2 
8 
8 
4 
4 
4 
4 
4 
4 
4 
4 


binary interna! Number of text bytes sent from secondary to primary 





Notes: 

1, For LACCBEGT abd LACCENDT, the first four bytes of the time stamp are local time in STCK format. The last four bytes 
are the conversion factor from GMT to local time. (Example: 982B5412 FFFFCASB). 

2. The Network Logical Data Manager (NLDM) uses the indicators in the first byte of the RH to select control and next PIUs. 

. The number of bytes counted are data bytes only. 

4, BSC connections do not have control PiUs, 


w 
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Record Type 40 (28) — Dynamic DD 


Record type 40 is written by IEFDB4F9 when an unallocation, concatenation, or 
deconcatenation request is processed. For an unallocation request, this record 
contains a device entry only for the data set unallocated. For a concatenation or 
deconcatenation request, this record contains a device entry for each DD entry in 
the TCTIOT. Its length is 66 bytes plus eight bytes for each device entry. 


Record type 40 contains the job log identification, user identification, step 
number, functional indicator, and device entries. Each device entry consists of the 
device class, unit type, device number, and EXCP count for the data set. 


set. 


Note: For more information on EXCP count and CPU time, see Chapters 8 and 9, 
respectively. 


The format is: 


orem [Nene [trai [Fomer | Souee [Deion 
fo [| TOORLEN | 2 [bnew [wre | Recsineth — 
[2 _| oonses [2 [einen [mere | Samentamermor 


TDDRFLG binary SVC 83 System indicator 
j Meaning When Set 
Reserved 
MVS/XA 
VS2 
Reserved 


TDDRCDTS binary SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 

TDDRCDTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF where F is the sign 


14] e TDDCPUID | 4 | eecpic JMRCPUID System identification (taken from SID parameter) 


TDDONTME binary | JMRENTRY Logon time, in hundredths of a second (If background job, 
this field contains the time the reader recognized the JOB 
card.) 

TODONDTE packed | JMREDATE Logon date, in the form 0OOY YDDDF where F is the sign. 
(If background job, this field contains the date the reader 
recognized the JOB card.) 

a TDDUDATA eee JMRUSEID User identification (taken from common exit parameter 
Sap nue Wane wey 


| TDDINVSQ | | 1 | binary | |JMRSTEP | Step number (first step=1,etc) number (first step = 1, etc.) 


ld - ee 


1The job name and the time and date that the reader recognized the JOB card for this job constitute the job log 
idantification. 









































Functional indicator 


Value Meaning 
2 Unallocation 

3 Concatenation 

4 Deconcatenation 
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Trova [Former [Sous 
7 EXCP count may be wrong* 
For each device, there is an eight-byte entry with the following format:? 


Nee binary Racord indicator 
Bit Meaning When Set 
TCTIEX 
8-25 Reserved 
TDDRVA | 18 | binary — binary | Pp Reserved 
TDDDEVC UCBTBYTS3 
TDDUTYP UCBTBYT4 


06 Reserved 

TDDVAR binary —— Length of device entry portion of this record. Besar as: 
(8 times the number of devices) + 2 

TDDCUAD UCBCHAN 








Device class 














Unit type 





Device number 


TDDNEXCP TCTDCTR 





EXCP count (see offset 44)? 





21f a GETMAIN for expanding the TCTIOT (the data area where EXCPs are maintained) fails, only 
the existing data sets are counted. If the functional recovery routine is entered, EXCP counting for 
the step is discontinued and no device entries are produced. If ADDRSPC=REAL is specified, the 
EXCP count does not include PCls. After a Dynamic Concatenation or Deconcatenation all EXCP 
counts are zeroed; therefore, the EXCP count in subsequent type 40 records will not reflect the total 
EXCP count for the step. This information is available in the type 30 record. For more information 
on EXCP count, see Chapter 8: 


3The device entry is zero when the DD entry is TERM, DUMMY, or unallocated DYNAM, (A DD 
DUMMY entry also results when a forward reference to a DD statement having that DD name is not 
found,) Entries for virtual |/O data sets are zero for class type, and X’7FFF’ for device number. |f 
the high order bit is on in the device number field, a virtual device is indicated. 
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Record Type 43 (2B) — JES2 Start 


Record type 43 is written by HASPINIT when an S JES2 command (to start JES2) 

is issued, and by HASPMISC when a $E SYS command (to reclaim the job processing 
that was being done on the named system in a Multi-Access Spool complex) 

is issued. This record contains a start/warm start indicator, JES2 start options, and 
the identification of the system whose job processing is to be reclaimed. Its length 

is 32 bytes. 


Record type 43 is also written by VS Personal Computing (VSPC) Program Product 
(5740-XR6). For more information on how VSPC uses this record, see VSPC 
Installation Reference Material, SH20-9205. 


Use IFASMFR to generate the JES2 record type 43 macro mapping. For more 
information, see ““Using the IFASMFR Macro to Address SMF Record Fields” in 
Chapter 4. 


The format is: 
































Tortets [Name [tenath [Format | Sowee | Cert 
ee 
| 2 [binary | jinternal internal =| Segment descriptor 
SMF43F ae as SVC 83 System indicator 
0-4 Reserved 
5 MVS/XA 
: VS2 
Reserved 
SMF43TME binary |SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 
SMF43DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF where F is the sign 
'14 | € | smra3sip | 4 | EBcDIC| SMCASID System identification (taken from SID parameter) 
aes) 12: | SMF43SBS | 2 | binary | internal Subsystem identification — X‘0002’ signifies JES2 
coe SMF43LRR plein elt Length of rest of record, excluding this field 
SMF43RST binary | internal Start/warm start indicator 
Bit Meaning When Set 
fT SMF430PT [ SOPTSTAT (in HCT) 


Bit Meaning When Set 
rs |S | smeasnry | 1 |binery [internal (| RecordtypeSSOSCS~S 
[20 | 14 | sMFaaRsv a 
baal i Reel all nm 









0 if O, record written for S JES2 command. 
If 1, record written for $E SYS command 
(see offset 24). 

1-7 Reserved 











JES2 start options. (This field is zero for $E SYS 
command.) 


Bit Meaning When Set 
0 Format the spool 






1 Cold start 
2 Request automatic initiator 
3 List replacement card option 







4-7 Reserved 


if SE SYS command, identification of system whose job 
processing is to be reclaimed (see offset 26). 
If S JES2 command, zero. 
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Record Type 43 (2B) — JES3 Start 





Record type 43 is written by LATINIK during JES3 and the converter/interpreter 
functional subsystem (C/I FSS) initialization. This record contains an indicator for the 
type of JES3 start, JES3 initialization deck origin type and contents, and JES3 procedure 
name. Its length is 54 bytes. 


The format is: 


[nome [eww Former [Sows Cw 


SMF43FLG binary SVC 83 System indicator 
Bit Meaning When Set 
0-5 Reserved 
6 VS2 
7 Reserved 


SMF43TME binary |SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 

SMF43DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDODF where F is the sign 


SMF43sID | 4 | EBCDIC|SMCASID System identification (taken from SID parameter) 





> 


Poinary [internal | Subsystem identification ~ X'0005' ignites JESS 
Peinary | id Rees 
[inary [internal | Length of restof record, excluding tafe 
Piney [| 


: ll 


[27 [16 | swrasave| 1 [binary [| ———=*d;sCR ear 
2s[ 1c | swrasust | 1 | piney | 


SMF43NMU EBCDIC | Set by IATINGS JES3 initialization deck origin type (taken from operator's 
response to WTOR macro) 


rT SMF430 RG 7 EBCDIC | Set by IATINGS JES3 initialization deck origin location (taken from 


operator's response to WTOR macro) 
ue SMF43PJ3 _ EBCDIC| SSCTSNAM 


in lEFJSCVT; 
Set by IATINGL 
(so |3z | smrasavu] 4 | binary | | Reserved toruser 





















) 


JES3 start record indicator (taken from operator's response 
to WTOR macro) 
Bit Meaning When Set 


0 Cold start 

1 Warm start 
2 Hot start 
3 
4 


Set by I|ATINGL 
during DSI; 
otherwise, set 

by IATINGS 













Start is with JES3 queue analysis 
JES3 global processor. This bit is always set if start 
isa cold start or warm start. 
5 JES3 local processor. This bit is always set if start 
isa hot start. 
6 Reserved 
7 Dynamic system interchange (DSI) was invoked by 
operator to convert a local processor to the global 
processor. Bits 2 and 4 will also be set. 

















Type Contents Location 
N Member name JCL in JES3 procedure 
M Member name Data set in JES3 procedure 


U 


JES3 procedure name 


Unit address Unit at specified address 
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Record Type 45 (2D) — JES2 Withdrawal 


Record type 45 is written by HASPNUC when a $P JES2 command (to withdraw 
JES2 from the system) is issued. It is also written at the abnormal termination of 
JES2 if JES2 retains control long enough to write the record. This record contains 


a termination indicator and JES2 completion code. Its length is 28 bytes. 


Record type 45 is also written by VS Personal Computing (VSPC) Program 
Product (5740-XR6). For more information on how VSPC uses this record, see 
VSPC Installation Reference Material, SH20-9205. 


Use IFASMFR to generate the JES2 record type 45 macro mapping. For more 
information, see “Using the IFASMFR Macro to Address SMF Record Fields” in 
Chapter 4. 


The format is: 



























SMF45FLG binary | SVC 83 System indicator 
Bit Meaning When Set 
Reserved 
(S| 5 | SMF45RTY| 1 |binary | internal _—i|_‘ Record type 
[20 [14 | SMrasRsv a 
0 If O, record written for $P JES2 command (JES2 
withdrawal). 


| oftests | Name | Length | Format | Source Description 
0-4 Reserved 
binary | SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 
|22 | 16 | SMF46LRR| 2 |binary | internal |_| Length of rest of record, excluding this field 
If 1, record written for abnormal JES2 termination. 


eo SMFASLEN | 2 [binary | internal | Record length 
5 MVS/XA 
SMF45DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF where F is the sign 
binary | internal Termination indicator 
Reserved 


| 2 | Smrassec [2 [binary | internal | _ Segment descriptor 
6 VS2 
(14 |e | SMF4ssiD | 4 |EBCDIC /SMCASID System identification (takan from SID parameter 
Bit Meaning When Set 
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Record Type 45 (2D) — JES3 Stop 


Record type 45 is written by IATINTK during JES3 and the converter/interpreter 
functional subsystem (C/I FSS) termination. This record contains an indicator for 
the type of JES3 stop, and JES3 completion code. Its length is 42 bytes. 


The format is: 


orien [Nemo [tana] Fome | Sowee [Cte 
2 Te | wremen [2 [acon [iene | Rese 
Pa swrasses [2 [inv 


SMF45FLG binary vernal 83 System indicator 
Bit Meaning When Set 
Reserved 
MVS/XA 
VS2 
Reserved 


Te [se [ swrasnty [1 [binery [internat | Record type 


SMF45TME binary | SVC 83 Time, in hundredths of a second, record wes moved to 
SMF buffer 
A SMF45DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 
/14 | € | smF4ssip | 4 | EBcDIC| SMCASID System identification (taken from SID parameter) 
/18 | 12 | SMF4ssBS | 2 binary | internal | | Subsystem identification — X'0005’ signifies JES3 
r20[ 14 [| swrasnsv | 2 [biney | | “Raed 
| 22 | 16 | SMF45LRA | 2 | binary [internal Langth of rest of record, excluding this fleld 
SMF45FG1 binary | Set by IATINTK JES3 stop record indicator 
Bit Meaning When Set 
JES3 or the C/I FSS abnormally terminated (taken 
from completion code in ECB) 
Dynamic system interchange was invoked by 
operetor to convert a local processor to the 
global processor 
- Reserved 
12-23 represent a user code. Note that the JES3 
completion code, as recorded on the operator's console, 
| 29 | 1D | SMF45US 1 | 4 | binary | internal User flags 
Tao [te | sMFasrvs | 8 |binery |_| Reserved for JES3 


SMF45J3C binary | Set by IATINTK JES3 completion code (taken from completion code in 
is always S 2FB., 
rae [26 [ swrasavu [4 [binary |__| Revered foruer SSCS 






























ECB) where bits 0-11 represent a system code and bits 
2a [1c | smrasnvi | 1 | binery 
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J 








Record Type 47 (2F) — JES2 SIGNON/Start Line (BSC only) 


Record type 47 is written by HASPRTAM when (1) a $S LNEn command (to 
start a line) is issued, (2) a $E LNEn command (to restart a line) is issued, and (3) 
a remote user signs on. This record contains a record indicator, remote name, line 
name, password, and message text. Its length is 52 bytes for a $S LNEn command 
and 90 bytes for a SIGNON record. 


Record type 47 is also written by VS Personal Computing (VSPC) Program Product 
(5740-XR6). For more information on how VSPC uses this record, see VSPC 


Installation Reference Material, SH20-9205. 


Use IFASMEFR to generate the JES2 record type 47 macro mapping. For more 
information, see “Using the IFASMFR Macro to Address SMF Record Fields” in 
Chapter 4. 


The format is: 


[ofteess [Nemo | Length [Former [Source Description 
ro To [swrarcen| 2 [einery [invrnns | Recording 
P22 | Smra7seG {2 [inary [internal | Segment deseritor 


SMF47FLG binary | SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
MVS/XA 
VS2 
ard ye 


(5 | 5 | smra7Aty| 1 [binary | intern | Recordtype 


SMF47TME binary |SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 

SMF47DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
SMGASID —T sya er where F is the sign 


| 14 | E | SMF47SID | 4 |EBCDIC|SMCASID —_| System identification (taken from SID parameter) 


ras [ 12 | smravses |_2 [binary internal | Subsystem identification — X ‘0002 signifies JES2 
rao [re | swramesv[ 2 [inary [i Revered 
/22 | 16 | SMF47LRR| 2  |binary |internal |_| Length of rest of record, excluding this field 


SMF47EVT binary Record indicator 
Bit Meaning When Set 
0-13 Reserved 
14 Record written for $$ LNEn command 
15 Record written for SIGNON 
Identification Section: 
SMF47LN1 binary | internal Length of identification section, including this field 
SMF47RMT RATNAME Remote name. (This field is filled in only if a remote 
terminal is connected to this line.) 


raé_| 24 | SMFA7LIN | 8 [EBCDIC[DCTDEVN _|Linename SOS 
44 | 2c | smra7Psw] 8 |EBCDIC|MDCTPSWD (inDCT)| Password 


The following fields apply when a remote user signs on: 












SMF47LN2 internal Length of rest of record, including this field 


SMF47MSG SIGNON record Message text. This field includes columns 35-70 of the 
SIGNON card image. 
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Record Type 47 (2F) — JES3 SIGNON/Start Line/LOGON 


Record type 47 is written by IATSNDT when a system network architecture (SNA) 
remote user logs on or by IATRJM3 when a binary synchronous communication 
(BSC) remote line is started or a BSC remote user signs on. 


For SNA, the record contains a record indicator, a work station name, a logical 
unit (LU) name, and a password. The record length for a SNA log on is 52 bytes. 
For BSC, the record contains a record indicator, a remote name, a line name, a 
password, and, for a remote sign on, a message text. The record length is 52 bytes 
for a started line or 102 bytes for a sign on. 


The format is: 


ores [Name [Leva] Format | sowen [SSCs CS 


2 ea SMF47SEG | 2 | binary [internal Segment descriptor 


SMF47FLG binary SVC 83 System indicator 
Bie Meaning When Set 
0-4 Reserved 
MVS/XA 
VS2 
Reserved 


}5 | 5 | SMF47RTY | 1 [binary | Record type 


SMF47TME binary ol 83 Time, in hundredths of a second, record was moved to 
SME buffer 

SMF47DTE packed SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


| 14 | E | smFa7sip | 4 | EBcDIC | SMCASID System identification (taken from SID parameter) 
| 18 | 12 | smra7sss | 2 | binary | internal | ——_—'|_ Subsystem identification — X'0005' signifies JES3 
| 22 | 16 | SMF47LRR | 2 |binary | internal | | Length of rest of record, excluding this field 


il 7 ia = 



















Bit Meaning When Set 
0-12 Reserved 



















[ATSNLD 13 Record written for SNA LOGON 
[ATRJM1 14 Record written for BSC started line 
[ATRJM3 15 Record written for BSC SIGNON 





6-114 System Management Facilities (SMF) 


) 












Tories [Nene [tone] Forme [sow [—————mipson 


Identification Section: 
SMF47LN1 binary internal Length of identification section including this field 


SMF47RMT IATRJM1 for line, | Remote name. (This field is filled in only if a remote 
IATRJM3 for terminal is connected to this line.) 
SMF47LIN 
IATSNDT for 
LOGON 


SIGNON 
44 | 2c | _smrazpsw | @ | EBCDIC | SIGNON/LOGON | Password 


[ATSNDT for Work station name 
The following fields apply when a BSC remote user signs on: 






















LOGON 


IATRJM1 for line, 
|ATRJM3 for 
SIGNON 


Line name 













LU name 








SMF47LN2 internal Length of message section, including this field 


SMF47MSG SIGNON record Message text. This field includes columns 35-70 of the 
SIGNON card image. 
ree [x | swrammve | @ [omy |__| Reed ors 
cee [ee [aweeonva | + [oy | | Remwatorome 
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Record Type 48 (30) — JES2 SIGNOFF /Stop Line (BSC only) 


Record type 48 is written by HASPRTAM when (1) a $P LNEn command 

(to stop a line) is issued, (2) a $E LNEn command (to restart a line) is issued, and 
(3) a remote user signs off. This record contains a record indicator, remote name, 
line name, password, line adapter address, and the number of EXCPs, negative 
acknowledgements to write text, data checks to read text, and time outs to read 
text. Its length is 75 bytes. 


Record type 48 is also written by VS Personal Computing (VSPC) Program 
Product (5740-XR6). For more information on how VSPC uses this record, 
see VSPC Installation Reference Material, SH20-9205. 


Use IFASMFR to generate the JES2 record type 48 macro mapping. For more 
information, see ““Using the IFASMFR Macro to Address SMF Record Fields” in 
Chapter 4. 


The format is: 



























ete SMFaSLEN EE ———— 
0-4 Reserved 
5 MVS/XA 
binary | SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 
SMF48DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF where F is the sign 
| 22 | 16 | SMF48LRR| 2  |binary | internal | | Length of rest of record, excluding this field 
SMF48EVT binary internal Record indicator 
15 Record written for SIGNOFF 


6 vs2 
/14 | & | SMF4ssiD | 4 | EBCDIC] SMCASID System identification (taken from SID parameter) 
Bit Meaning When Set 
(26 | 1A] smFasRvi| 2 [binary || Reserved ee ——s—“—‘“SsSCSC—s 





le SMF48FLG oP SVC ee ciel System indicator 
Reserved 

18 | 12 | SMF48SBS | 2 [binary [internal = Subsystem identification — X’0002’ signifies JES2 
Q-13 Reserved 


Bit Meaning When Set 
rs [S| swraenty | 1 [binary [intenei (| Recordtype—SSOSCSC~—~S~S 
i ae aa 
14 Record written for $P LNEn command 
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rome [vere [enw [rome [tow [een 
SMF48RMT RATNAME Remote name. (This field is filled in only if a remote 
terminal is connected to this line.) 


(36 | 24 | SMF48LIN | 8 |EBCDIC|DCTDEVN | Linename 


SM F48PSW MDCTPSWD Password 
(in DCT) 

SMF4810 binary | MDCTSXCP or 
MDCTxcP?2 

SMF48NAK binary MDCTSNAK Number of negative acknowledgements to write text 
or MDCTNAK? 

SMF48DCK binary MDCTSDCK Number of data checks to read text 
or MDCTDCK} 

SMF480UT binary MDCTSTO Number of time outs to read text 
or MDOCTTO?} 

SMF48ERR binary MDCTSREM Sum of all other line errors 
acahaMe MDCTREM?2 


72 | 48 | SMF48LAA | 3 | EBCDIC) Line | Lineadaptermumber number 


1The flald names beginning with MDCTS are for SIGNOFF and contain session totals; the 
other fieids are for $P LNEn commands and contain connection totals. 
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Record Type 48 (30) — JES3 SIGNOFF /Stop Line/LOGOFF ) 


Record type 48 is written by IATSNLC when a system network architecture (SNA) 
remote user logs off or by IATRJM4 when a binary synchronous communication 
(BSC) remote line is stopped or a BSC remote user signs off. 


For SNA, the record contains a record indicator, a work station name, a logical 

unit (LU) name, a password, and a line I/O count. The record length is 68 bytes. 
For BSC, the record contains a record indicator, a remote name, a line name, a 
password, a line adapter address, and line I/O counts. The record length is 95 bytes. 


Note: For BSC, the statistics in this record are accumulated for the line from 
SIGNON/LOGON to SIGNOFF/LOGOFF. 








































The format is: 
a ———— 
SMF48FLG binary wert 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
Reserved 
| 5 | 5 | SMF48RTY | 1 [binary | internal | Record type 
binary SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 
| 18 | 12 | smrFagsss | 2  |binary | internal | Subsystem identification — X'0008" signifies JES3 
rao [v4 [ swrsensv [2 [eine | (| Renee 
| 22 | 16 | SMF48LRR ) 2 | binary | internal Length of rest of record, excluding this field 
1¢ SMF48RMT EBCDIC | IATRJM4 Remote name. (This field is filled in only if a remote 
for BSC terminal is connected to this line.) 
{ATSNLC Work station name 
for SNA 
SMF48LIN EBCDIC | IATRJM4 Line name 
for BSC 
IATSNLC LU name 
for SNA 
SMF48PSW EBCDIC | IATRJM4 Password 
for SNA 
{ATRJM4 EXCP count 
for BSC 


ete swraacen | 2 [ey [mornt | Recort oar 
5 MVS/XA 
SMF48DTE packed SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 
SMF48EVT binary Record indicator 
j Meaning When Set 
Reserved 
IATSNLD Record written for SNA LOGOFF 
IATRJM4 Record written for BSC stopped line 
IATRJM4 Record written for BSC SIGNOFF 
for BSC 
SMF48TRN binary 
IATSNLC SEND count 


6 VS2 
| 14 | £ | smFassip | 4 |eBcDIC | SMCASID System identification (taken from SID parameter) 
rae [aa | swewanve [= [aie | _*|Reen 
IATSNLC 
for SNA 
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IATRJM4 Number of line errors 
for BSC 
IATSNLC RECEIVE count 


for SNA 


IATRJM4 
for BSC 


Length 
ai SMF48ERS | 4_ | binary 
SMF48TOT binary 
IATSNLC 
for SNA 
binary |ATRJM4 Number of negative acknowledgements to write text 
for BSC 
IATSNLC RECEIVE negative response count 
for SNA 











Number of time outs to read text 

















SEND negative response count 



























SM F48S0 binary \ATRJM4 Number of command rejects 
for BSC 
[ATSNDM SEND positive response count 
for SNA 


65%] 41'| smeaast | 1 | binary | iATRIMA Number of interventions required 


binary IATRJM4 Number of bus-out checks 
for BSC 
1ATSDR 
for SNA 


67] 43°] smessss_ | 1_| binary | 1ATRIMA Number of equipment checks 


The an fields apply only to BSC: 
SMF48S4 1 binary IATRJM4 Number of data checks 


ee [a [swraass [1 binery | iaTRIMa | Nomar of ate worm 
| 70 | 46 | smFasss | 1 | binary | IATRIMA | Number oflostdatas 
_7| 47 | smraausr | 9 | piney || Reserve 


ete oe eee eee 
83 | 53 | sMFasRVJ | 8 | binary [Resevedfor JESS. s—~—“—*S*~*~*~S~CS™ 


| se | snrasrve en 


1For SNA, adjust offsets to account for the increased length. 


66 42 £SMF48S1 
67 43 SMF48S2 
69 45 SMF48S3 





RECEIVE positive response count 
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Record Type 49 (31) — JES2 Integrity (BSC only) 


Record type 49 is written by HASPRTAM when a remote user attempts to sign on 
with an invalid password. This record is the same as record type 47 except the 
password is invalid. It contains a record indicator, remote name, line name, invalid 
password, and message text. Its length is 90 bytes. 


Record type 49 is also written by VS Personal Computing (VSPC) Program 
Product (5740-XR6). For more information on how VSPC uses this record, 
see VSPC Installation Reference Material, SH20-9205. 


Use IFASMFR to generate the JES2 record type 49 macro mapping. For more 
information, see “Using the IFASMFR Macro to Address SMF Record Fields”’ in 
Chapter 4. 


The format is: 


[oft [Nome [Lena [Formet | Sowee ~~ non 
ro] o | swreouen | 2 [piney [meme | Remedi 


|2 [2 | smragsec | 
SMF49FLG binary |SVC83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
6 VS$2 
7 Reserved 


Cs | suraonty [1 [inary [ineernat | Record eye 


SMF49STME binary |SVC83 Time, in hundredths of a second, record was moved to 
SMF buffer 


















SMF49DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


internal Subsystem identification — X’0002’ signifies JES2 


[i 12 | swrsoces 3 
rao [14 | swreonsv | 2 [binary | ———*dt—Rewned SSS 
SMF49LRR Length of rest of record, excluding this field 


TEBCDIG|SMGASID | _ System identification (taken from SID parameter 










SMF49EVT binary | internal Record indicator 
Bit Meaning When Set 
Q-13 Reserved 
14 Started line 
15 Record written for SIGNON 


Identification Section: 
26 1A SMF49LN1 binary | internal Length of identification section, including this field 








i 26. | EBCDIC, SIGNON record Invalid password 


Length of rest of record, including this field 
SIGNON record Message text. This field includes columns 35-70 of the 
SIGNON card image. 


Message Section: 
52 34 SMF49LN2 


SMF49RMT RATNAME Remote name. (This field is filled in only if a remote 
terminal is connected to this line.) 
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Record Type 49 (31) — JES3 Integrity 


Record type 49 is written by IATSNLS when a system network architecture (SNA) 
remote user attempt to logon on with an invalid password or by IATRJM3 when a 
binary synchronous communication (BSC) remote line user attempts to sign on 
with an invalid password. 


For SNA, the record contains a record indicator, a work station name, a logical 
unit (LU) name, and an invalid password. The record length is 52 bytes. For BSC, 
the record contains a record indicator, a remote name, a line name, an invalid 
password, and, for a remote sign on, a message text. The record length is 90 bytes. 


The format is: 


Offers | Name | Length] Format | source |Description 
| 0 | oO | sMraoLen | 2 | binary | internal | Record tength 
_2 | 2 | smrassec | 2 | binary | internal | Segment descriptor 


SMF49F LG binary | SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
° VS2 
Reserved 


Ts [8 | swrasnty [1 [inary [invernet | Recordtype SOS 


SMF49TME binary SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 
A SMF49DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 
/14 | E€ | SMFagsiD | 4 | EBCDIC| SMCASID System identification (taken from SID parameter) 
| 18 | 12 | SMFagsBs | 2  |binary | internal |_| Subsystem identification — X'0005' signifies JES3 
pe Pa smraonsv [2 [binary [| Revered 
SMF49LRR | 2 [binary | internal Length of rest of record, excluding this field 


SMF49EVT binary IATRJIM3 Record indicator 
for BSC Value Meaning 
IATSNLS 
| for SNA Terminal not defined (BSC) 

Invalid password (BSC) 
Line already signed on (BSC) 
Terminal already signed on (BSC) 
Session limit exceeded (SNA) 
Work station undefined (SNA) 
Invalid password (SNA) 
Bind failed (SNA) 


Identification Section: — 
SMF49LN1 | binary | internal Length of identification section, including this field 


SMF49RMT EBCDIC] IATRJM3 Remote name. (This field is filled in only if a remote 
for SIGNON terminal is connected to this line.) 
IATSNLS 
for LOGON 
SMF49LIN EBCDIC| |ATRJM3 
for SIGNON 
IATSNLS 
for LOGON 


Work station name 
| 44 | 2c | smF4agpsw | s8_ | EBcDIC| SIGNON/LOGON Invalid password 


The following fields apply only to BSC: 
me lng Section: 








OnNOOAWN — 





















Line name 









LU name 





SMF49L internal Length of message section, including this field 


EBCDIC| SIGNON record Message text. This field includes columns 35-70 of the 
SIGNON card image. 
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Record Type 50 (32) — ACF/VTAM Tuning Statistics 


Record type 50 is written by ISTINCTS to report ACF/VTAM tuning statistics. 
If specified, tuning statistics are collected when a user-specified time interval 
expires. Tuning statistics and the time interval are specified in an option when 
ACF/VTAM is started or its options are modified. 


The format is: 











System indicator 





Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 






cee binary Segment descriptor 
6 VS2 


SMF50FLG binary 
Reserved 


as | awrsoner| + eee [wee [needs 


Pp mele ee | 
SMF buffer 
SG a 
OOYYDDDF where F is the eee 
) = | smrsosio | 4 | escDic| sMcAsID SMCASID System identification (taken from SID | _ System identification (taken from SID parameter) 
ee oe eee 
rs im | avrenoun | + [ony [ima | Menu anpiowtoariens 
0 [= [ swreooun [+ [sy [nwa | ___Ganot WRITE chan ores 
ae [m2 | suraacno | + _[sinoy [mare | Got ef READ hone rowers 
5 | 2 | sureoatn | + [onow [mona | Towtnmberofoueionabes 
[a2 [26 | swesoate [+ [omy [imar| Avanos on ena o READ hel rowan 
rae [2 | awrsorar | * [ine [inert | _Nambwrofnpona VS 
Tso] se | awrsorve | + [nina [imine | Sinowrofowbounsrivs 


[=| 6 | swesonur | + [enw [imwrna_| Tot number fr ur 
53 | 3a | SMF50SLD | 4 | binary | internat | Number of times NCP entered slowdown. 
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Record Type 52 (34) JES2 LOGON/Start Line (SNA only) 


Record type 52 is written by HASPRTAM when (1) a $S LNEn command (to start 
a line) is issued, (2) a $E LNEn command (to restart a line) is issued, and (3) a 
remote user signs on. This record contains a record indicator, remote name, line 
name, password, and message text. Its length is 38 bytes for a $S LNEn command 
and 62 bytes for a SIGNON record. 


Use IFASMFR to generate the JES2 record type 52 macro mapping. For more 
information, see ‘“‘Using the IFASMFR Macro to Address SMF Record Fields’’ in 
Chapter 4. 


The format is: 


[ote [Name [tenati]Format [Source | Dewsrinton 
-o--9 Saree SMF52LEN 2 besey internat _ Record length 
| 2 | binary _ Segment descriptor 


y SMF52FL6 aie sovernal 83 System indicator 


Bit Meaning When Set 
(é | 8 | sMFsanty | 1 | binary [internal | Record type 


0-4 Reserved 
SMF52TME binary |SVC 83 Time, in hundredths of a second, record was moved 

A a al 
to | AY swrszone | a form 0OOYYDDDF where F is the sign 

ria] € | swrsasi> | 4 | eecpic|swcasip | System identification (taken from SID parameter) 
re 12] SMFszPOF | 2 | binary internal | Offsettoproductsection 
20 [14 | SMFS2PRL | 2 | binary internal | __Lengthof productsection 
r22[ 16 | sMF52PRN | 2 | binary [internal | Number of product section 
[2a [18 | sMFs2iDO | 2 | binary [internal | ___Offset to identification section 


26. | 1A| sMrsziDL | 2 | binary |internal | Length of identification section 
/28 | 1C | SMF52IDN | 2 | binary |internal | Number of identification section 


Product Section: 
SMF52SUB binary Subtype id, 1 = Record written for LOGON 
2 [Pinay fievernat 2 = Record written for $S LNEn 

a2 [ 20 [ swrsaven | 2 | EBCDIC| internal | Recordversion number 
(34 | 22[ smrs2sys | 4 | EBCDIC/internai —|_—Subsystem name, ‘JES2. 

Identification Section: | | | | 

38 26 | SMFS5S2RMT | 8 | EBCDIC|RATNAME | Remote name (only for Subtype id = 1) 

a6 | 2e| smeszun | 8 | €BCDIC|DCTDEVN | Lineneme SS 
(54 | 36] smFs2psw | 8 | EBCDIC/MDCTPSND |  Linepassword 



















5 MVS/XA 
6 VS2 
7 Reserved 
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Record Type 53 (35) JES2 LOGOFF /Stop Line (SNA only) 


Record type 53 is written by HASPRTAM when (1) a $P LNEn command 

(to stop a line) is issued, (2) a $E LNEn command (to restart a line) is issued 
and (3) a remote user signs off. This record contains a record indicator, remote 
name, line name, password, line adapter address, and the number of EXCPs, 
negative acknowledgements to write text, data checks to read text, and time 
outs to read text. Its length is 85 bytes. 


Use IFASMER to generate the JES2 record type 53 macro mapping. For more 
information, see ““Using the IFASMFR Macro to Address SMF Record Fields”’ in 
Chapter 4. 

































The format is: 
[Orewa [Name [toneth[ Former [Source [meron 
aie. SMF5SLEN | 2 [binary internal | Record length 
SMF53FLG binary /|SVC Cn an! System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
St 7 
5 | 5 SMF53RTY | 4 [binary | binary | —-s«sRecordtype— i ( tst—<“(‘(C‘“‘“‘iCi‘i‘is™SOCCC*r type 
SMF53TME binary ee 83 Time, in hundredths of a second, record was 
moved to SMF buffer. 
SMF53DTE packed |SVC 83 Date record was moved to SMF buffer, in the 
form OOYY DDODF where F is the sign 
(18 | 12 | smMFs3rporF_ | 2 [binary internal Offset to product section 
(20 | 14 | SMFSSPAL | 2 [binary linterna) Length of product section 
r22[ 16 | smrsaeRn | 2 [binary |internat | __ Number of product section 
[24 | 18 | SMF53iD0_ | 2 |binary |internal | Offset to identification section 
SMF53IDN | 2 [binary [internal | __ Number of identification section 
ieeeae A a ARRANGE SSRN 
SMF53SUB binary Subtype id, 1 = Record written for LOGOFF 
2 = Record written for $P LNEn 
/32 | 20 | SMF53VER a | EBCDIC Record version number 


| SMF53SEG | 2 [binary | internal =| Segment descriptor 
6 VS2 
14 | E | SMF53SID | 4 |EBCDIC|SMCASID System identification (taken from SID parameter) 
ae SMF53IDL | 2  |binary |internal = Length of identification section 
'34 | 22 | sMFs3sys | 4  |EBCDIC Subsystem name, ‘JES2’ 
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[of [Nome [tana] Formet | Souren Deinion 


Identification Section: Pee ae 
| 38 | 26 | SMF53RMT g |EBCDIC |RATNAME | __ Remote name 


rae [26 | sMFsoLn | 8 [eacvic|DCTOEVN | _Linename SSCS 
SwFsapSW | ~@[EBCDIC [MDCTPSND | Line paswor 


ps4 | 36 
SMF53CTR binary MDCTSCNT Number of VTAM request processed 
or MDCTVREQ! 
SMF53CTR +4 binary MDCTSCNT + 4 Number of exception responses 
| or MDCTXRSP! 
70 SMF53CTR +8 binary MDCTSCNT +8 Number of LUSTAT’s received 
or MDCTLUST1 
74 SMF53CTR +12 binary MDCTSCNT + 12 Number of bid rejects 
or MDCTBIDR1 


78 SMF53CTR +16 binary MDCTSCNT + 16 Number of temporary errors 
or MDETMPER1 
| 82 | 52 | SMF53ADP 3 |EBCDIC |internal Line identifier, ‘SNA’ _ 


1The field names MDCTSCNT are for LOGOFF and contain session totals; the other fields are for $P LNEn 
commands and contain connection totals. 
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Record Type 54 (36) — JES2 Integrity (SNA only) 


Record type 54 is written by HASPRTAM when a SNA remote user attempts to 
sign on with an invalid password. It contains a record indicator, remote name, line 
name, invalid password, and message text. Its length is 62 bytes. 


Use IFASMFR to generate the JES2 record type 54 macro mapping. For more 
information, see ““Using the IFASMFR Macro to Address SMF Record Fields” in 
Chapter 4. 


The format is: 


[ofits [Name [Length] Format] Sowes [SSC 
oes 2 eee ee, ee 


SMF54F LG binary Ce 83 System indicator 
Bit Meaning When Set 
Reserved 
MVS/XA 
VS2 
Reserved 


ope aan [he hee 
moved to SMF buffer 
pS [rene [Spee [MCS | emoowvooor wee ritedgn 
form OOYYDDDF where F is the sian: 

a & | swrsasio | 4 [EBCDIC/SMCASID | System identification (taken from SID parameter) | 
[ie | 12 [swrsaror [2 [binary internal | __Offeet toproduct section 
[20 | 74 | -swFsapRL [2 [binary [internat [___Lenath of product section 
p26 | SMreaPRN [2 [binary [internal____| Number of productsection 
[24_[ 18 | SMF54iD0__| 2 [binary internal | Offset to identification ection 
[26 | 1A | SMFS4i0L | 2 [binary internal | __Length of identification section SC 
[28 [ 16 | SMFS4IDN | 2 [binary [internal | Number of identification section 
— Section: [ee eee: eee es ere eee 

SMF54SUB |2 [binary internal Subtype id, _1 = Record written for LOGON 

oe erie a eee eee 
(34 | 22 | smFsasys | 4  [EBCDIC|internal | Subsystem name, ‘JES2” 
oe ear Section: as SC CRAG N  SEREN S 

26 | SMFS4RMT | 8 |EBCDIC|RATNAME | ___—sRemotename 
[ae [26 | sursanew |e —lescorclumrs toson [Reno peor 
[ea | 36 | smrsapsw | @  [EBCDIC] User's Logon | _LinePasword SSCS 
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[20 [14 [ smesesue | 2 [binary | internal | Record subpe 


Record Type 55 (37) — JES2 Network SIGNON Record 


Record type 55 is written by HASPNET at each node when a start networking 
command is executed. The initial SIGNON is recorded at the node to which 
the SIGNON was sent; the response SIGNON is recorded at the node that 
originated the initial SIGNON. Its length is 58 bytes. 


Use IFASMFR to generate the JES2 record type 55 macro mapping. For more 
information, see “Using the IFASMFR Macro to Address SMF Record Fields” in 
Chapter 4. 


The format is: 


[ofrets [ Name [Uanath[ Format [Sours [warp 
ee 


Paes. eee binary Segment descriptor 


ye SMF55F LG SVC 83 System indicator 


Bit Meaning When Set 

0-4 Reserved 
rs [5 | smronty | 1 [binary | internal | Recordwype OOS 

eye pereme |S Pe ee ese 
eve to SMF buffer 

fe LA [oerere A prt | eS | tommoorvooor unos ernesign 
the form OOYYDDDF, where F is the sign 

[i4_|_E | swrssi>_| 4 [EBCDIG| SMCASID | System identification (taken from SW parameter) 

(18 | 12 | smFsssBs | 2 |binary | internal Subsystem identification X'0002’ signifies JES2 

























5 MVS/XA 
6 VS2 
7 Reserved 





22. | 16 | SMFS55LRR | 2 = [binary | internal | Length of rest of record, not including this field 

ee EneMe) _Ccneee 
0 Response sign-on 

(42 | 2A | SMFSSNPW | 8 |EBCDIC|  NCCINPAS Node password 


TsMFssMEM | 1 [binary | _ NCCIQUAL 
(off = initial sign-on) 
[s0_[ 32 | swresunm | 8 [EBcDIG| DCTDEVN 











SMF55FG1 binary Sign-On Status Flag: 
1-7 Reserved 


Bit Meaning When Set 
[a4_| 22 | SMFSSLPW | 8 [EBCDIC| NGCILPAS 
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Record Type 56 (38) — JES2 Network Integrity Record 


Record type 56 is written by HASPNET whenever an attempt to SIGNON 
contains an invalid line or node password. Its length is 58 bytes. 


Use IFASMFR to generate the JES2 record type 56 macro mapping. For more 
information, see “Using the IFASMFR Macro to Address SMF Record Fields” in 
Chapter 4. 


The format is: 


| Offsets | Name [Length] Format | Souree | Desecription 
= SMF56LEN | 2 |binary_| internal |___—Record length 
CT: ae eae Segment descriptor 


iy SMF56F LG SVC 83 System indicator: 


Bit Meaning When Set 

0-4 Reserved 
/5 | 5 | SMFs6RTY | 1 |binary | internal | _—sRecordtype 

a ial lia =e 
moved to SMF buffer 

A kl lia 
in the form OOYYDDDF, where F is the ea ance ee 

14 | & | smFsesiD | 4 |EBCDIC System deneiiiestien Maken from the SID | System identification (taken from the SID parameter) 

eo eee a 


[20_[ 14 | smesesue | 2 [binary | internal | Record subtype 
22, | 16 | SMFS6LRR | 2 |binary | internal | Length of rest of record, not including this field 











5 MVS/XA 
6 VS2 
y Reserved 

















SMF 56FG1 binary Sign-on Status Flag: 
1-7. Reserved 


24 | 18 | SMFSeNNM | 8 |EBCDIC| NCCINODE | __Nodename 
Bit Meaning When Set 
0) Response sign-on 
2 See EE. SA 
[EBCDI6| —NecINPAS | Neds pasword 


/32_| 20 | SMF56eMEM | 1 [binary | NCCIQUAL 
(off = initial sign-on) 
re SMF56LNM ae DCTDEVN 
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Record Type 57 (39) — JES2 Network SYSOUT Transmission Record 


Record type 57 is written by HASPNET whenever JES2 completes a network 
SYSOUT transmission. This record contains original and current job identifiers, 
transmitter start and stop times, and a count of the records transmitted. Its 
length is 104 bytes. 


Use IFASMFR to generate the JES2 record type 57 macro mapping. For more 
information, see ‘“Using the IFASMFR Macro to Address SMF Record Fields”’ in 
Chapter 4. 





















The format is: 
[ores [Name [Uanath] Format [Source [Demin 
[2 [2 | SMFS7SEG | 2 |binery | internal | Segment descriptor 
Bit Meaning When Set 
0-4 Reserved 
5  MVS/XA 
6 vs2 
[S| 5 | SMFo7ATY | 1 [binary | internal | Record type 
SMF57TME binary SVC 83 Time, in hundredths of a second, record 
was moved to SMF buffer 
SMF57DTE packed SVC 83 Date record was moved to SMF buffer, 
in form OOYYDDDF, where F is the sign 
| 14 | E | SMF57SID | 4  |EBCDIC | SMCASID System identification (taken from SID parameter) 
[20 | 14 | swrs7sus_ | 2 [binary | internal (| _—‘RecordsubtypeSOSC~—~—~—SCSCS 
| 22 | 16 | SMF57LRR | 2 [binary | internal Length of rest of record, not including this field 
| 24 | 18 | SMF57JID | 8 |EBCDIC | JCTJOBID Original job identification 
| 32 | 20 | SMF57CJD | 8 |EBCDIC | JCTJOBID Current job identification 
48 | 30 | SMF57ENN | 8  |EBCDIC | NITNODE 
/56_| 38 | SMF57NNN | 8 |EBCDIC | NITNODE 
| 64 | 40 | SMF57DVN | 8  |EBCDIC | DCTDEVN SYSOUT transmitter device name 
| 72 | 48 | SMF57TSS | 4 [binary | SVC11 SYSOUT transmitter start time 
| 80 | 50 | sMF57TPS | 4  |binary | svc11 SYSOUT transmitter stop time 
| 84 | 54 | SMF57DPS | 4 _ |packed | SVC 11 SYSOUT transmitter stop date 
88 | 58 | smrs7Tsi_ | 8 |EBCDIC | JCTNACCT 
| 96 | 60 | smMFs7Tsi | 4 |EBCDIC | $SID | —SYSOUT transmitter system identification 


SMF57FLG binary SVC 83 System indicator: 
lini Reserved 
1 | 12 | SMrsrses | 2 [pinay inert Subsystem identification X’0002’ 
signifies JES2 
(40 | 28 | SMFS7ONN | 8 [EBCDIC | NITNODE | Originalnodename 
.76 | 40 | sMrs7Dss_| 4 |packed | SVC11 | _—SYSOUTtransmitter startdate 
| 100] 64 | SMFS7CNT | 4 [binary | NSTCOUNT |  Countoflogical TPrecords 
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Record Type 57 (39) — JES3 Networking SYSOUT Transmission Record ) 


Record type 57 is written by IATNTSD whenever JES3 completes a network 
transmission. This record contains original and current job identifiers, 
accounting information, transmission path, and destination. The length is 170 bytes. 


The format is: 











[Torte [Name [ength [ Format | Sowes [Dacron 
2] 2] SMENSLEN |_2.__Teinery__tntrnel_}_sord ong 
| 2 | 2 | SMENJDES | 2 [binary | internal | _—Segmentdescriptor 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
6 VS$2 
)5 | 5 | SMFJNRTY| 1 |binary | internal _—s|_—sRecordtype, 
a a la 
fecord was moved to SMF butter 
buffer, in the form OOY YDDDF 
where F is the sign 
ee eee Pee ee | eet 
parameter) 
[ao [a [inary [Revved we 
EC 
[24 [18 | SMFNJETM| 4 [binary | STRTIME | Tranemissionstar time 
fae [16 swenseor [4 escoe [seers | “Frenemiion rece 


SMFNJFLG binary SVC 83 System indicator 
Reserved 
SMFSUBID binary internal Subsystem identifier X‘'O005’ signifies 
ea 
SMFNJIND EBCDIC internal Job type indicator 


JB — indicates data is a job stream 


OP — indicates data isaSYSOUT data stream 


[aa 32 | SMFNINAM| —@ _[EBCDIC | NUEJOBNM | Jobrame SOS 
[a2_[ 2a | SMENuNUM| 4 [EBCDIC | _NJMSGINO | Current JES@-amigned|ob number 
[4é_| 26 | SMFNJONM] 2 [EBCDIC | NJEJOBNO | Original number 
fae [of —~(| 2 binery | C*YCReneed SSOSCSCSCS 
[so [32 | SMENUPGM| 20 |EBCDIC | NJEPRGMA | Programmername 
T7046 | SMENIUSR| 8 [EBCDIC | NJEUSRID | Origin or notify user identifier SCS 
[7e_[ ae | swensact] 8 [eBcbic | NEACCT | Networking account number 
rae [56 | sMeNuoPT | 8 |escDIc | NJEDEPT | Department number SS 
[oa se | smenvet>| 8 [eBcoic | NJEBLDG | Building number SSS 
[102 | 66 | smeNJLOc| 8 |EBCDIC | NJEROOM | Location number SSCS 
[10 | 6€ | SMENORG] 8 [EBCDIC | internal | Joborigin SSC 
rie [76 | SMENRMT| 8 [EBCDIC | intemal | Secondary job orgin SSCS 
[126 [76 [ SMFNIXEQ] 8 _[EBCDIC | NJEXEN | Executionnode name 
risa [86 | SMFNJEXU| 8 [EBCDIC | NJEXEON | Execution user identifi SSCS 
[a2 [se | SwFNJDST| 8 [EBCDIC | JDSDEST | Destination node name SS 
ris0 [96 | SMFNUPTH | 8 [EBCDIC | NJEPATH | Transmission path node name 
risa | 96 | SMFNuRcT| 4 [binary | XRCDCNT | RecordcousSOSC~—S 
riez [AZ| CMRNJCNT] 4 [binary | XCHARCNT | Compressed bytecount SSS 
ries | AS | SMeNuTAN| 4 [binary | XBUFCNT | Transmission buffer counts SSS 
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Record Type 58 (3A) — JES2 Network SIGNOFF Record 


Record type 58 is written by HASPNET at each node when a networking session 
is terminated. The record contains the node name, member number, and line name. 
Its length is 42 bytes. 


Use IFASMER to generate the JES2 record type 58 macro mapping. For more 
information, see ““Using the IFASMFR Macro to Address SMF Record Fields”’ in 
Chapter 4. 


The format is: 


[ots] Nome [ume] Forme [Sows Omi 
31 2 SMFS8LEN | 2 | binary | internal_|_Record length 
Tsmrseses [2 | binary | internal | Segment descriptor SC 


SMF58F LG binary SVC 83 System Indicator: 
Bit Meaning When Set 
0-4 Reserved 
MVS/XA 
VS2 
Reserved 


SMF58TME binary SVC 83 Time, in hundredths of a second, record was moved 
to SMF buffer 
A SMF58DTE packed SVC 83 Date record was moved to SMF buffer, in form 
OOYYDDDF, where F is the sign 


ia_[-€ | swreasio [4 | EBCDIG | SMCASID | System identification ——S—SC~S 
/18 | 12 | SMF5ssBsS | 2 | binary | internal | — Subsystem identification X‘0002’ signifies JES2 

[20 [14 | SMFSBSUB [2 | binary | internal | Record subtype 
[22_[ 16 | swrseian | 2 | binary | Internal | Length of ret of record, not including this eld 
[a [18 [ SMFSBNNM | 8 | EBCDIC | NITNODE | NodenameSC~*d 
[32_[ 20 | SMFSBMEM [1 | binery | DCTNO | Member number OSS 
ea [at | srsenvi [1 [winery [| Reeve 
[a4_[22 [| SMFSBLNM | 8 | EBODIC| DGTDEVN | Linename SOS 
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Seo UAE. Rowalottr whuek upolereo, 
Roos. OF 


Record Type 59 (3B) — MVS/BDT File-to-File Transmission Record 


Record type 59 is written by BDTACMN when MVS/Bulk Data Transfer 
(MVS/BDT) completes a file-to-file transmission. MVS/BDT writes the record 
from the global node where the transaction is queued. MVS/BDT produces a 
record type 59 whether or not the transmission successfully completes. 


{he record contains sections for MVS/BDT product information, transaction 
idgntification, file-to-file (FTF) and network information (transaction type 
sectign), transaction data, transaction accounting information (which is 

optiorl), and transmission information. There are two 40-byte fields for user 
informaNon at SMF59US1 (transaction data section) and SMF59US2 (transmission 
data section). 


The SMF recoN mapping macro for record type 59 is IFASMFR. IFASMFR uses 
BDTDSMF, and WiVS/BDT macro instructions, to generate the mapping. If you 
want record type 30 mapping, make sure that both IFASMFR and BDTDSMF 
reside on the same micro library. BDTDSMF is written in assembler language and 
is supplied on SYS1.AMODGEN. 


The length of record type 49 is 548 bytes plus the length of the transaction 
accounting section if included. (The transaction accounting section is optional.) 


MVS/BDT invokes the optional Sser exit BDTUX24 prior to writing the record. 


The format is: 


[ers [vee [inn [omer [seems [RRR 


Ben 4 SMF59SEG | 2 | binary binary j internal Segment descriptor 


SMF59FLG binary SVC 4 System indicator 
Bit Meaning when set 
0 Subsystem name follows‘system identification 
1-4 Reserved 
5 MVS/XA 
: OS/VS2 
Reserved 


| SMFSOTME | | 4 | binary SVC 83 Time, in hundredths of a second, record was Written by SMF. 


Matin pais SVC 83 Data record was written by SMF buffer, in the farm OOyydddF, 
where F is the sign. 


a sve 
i ee 
f2_[ie | swrsover | 2 | 80016 [internat |Vewionnumber 
[2a_[1e_| swrsoor | | viary | inva _[Ofiat to MVS/BDT predation 
fas_[1c_[ swrssueo [2 | binoy | internet [Length of MVSIBDTerodietwetion SS (Y 
fs0_[1e [| swrsaneo [2 [inary | inwrnat [Number of WVSTBDT productectons 


(Continued) 
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[orien [Ware [wwe [Format [Sows [esreon 
/32 | 20 — SMF590T] binary internal Offset to transaction identifier section 
(36 [24 SMF59LTI =e Length of transaction identifier section 


Se [26 | SMF59NTI | 2 | binary | internal Number of transaction identifier sections 
a0X [28 [SMresOTT || binary | internal [OF set to wansaction type section 


cage awrsocrt | 2 [sey [iat [Lar reson pe men 
a6_|3q_[ sursontr | 2 | diner | inert | Number of wansction wpe sections 
f4a_[a0\["swrsooTo | + | biney | inernat [fet o warscton datasecton 
[sa_[2e_[\swrsouto [| 2 | binary | inernat | Lerath of warscton deteweevon 
fs4_[36 | SqrsowTo | 2 | biney | imernal [Number of wansection deteseetons 
[s6_[a8 | srtigoors [| 4 | binary | terse! | Offet to wansnisionsestion 
feo_[sc_[ swrebers [2 | binew | imeral [Length of vaneminsion ection 
fae wren [2 [orev [erat [ort oer sets 

fo _[40_| swrcoora\ 
ear anes [oar nana [ing semi roi 
= [= oon] ow 


MVS/BDT Product Section: 
SMF59RCD \EBCDIC MVS/BDT version number (‘01’) 


[a [swranor |e ae [se — rere 
)+10 [+A | SMF59SSN | | EBCRIC | TVTSYSID | MVS/BDTnodename sid node MVS/BDTnodename sid 


+18 |}+12 | SMFS59TID eh Transaction type identifier — “FF” for FTF, 


Transaction Identifier Section: 
SMF59TNU EBCDIC MVS/BDT job number 


ES 
rsa [ee | swrsora |e | | \ [fewes OS 
p20 [+14 | swrsoras |e | eBcbic | TVTSvsIDy [MVSIBDT wanecton queuingnode 
rae [ec [ swrsora |e [| \rewma 
ras [at ooreore [of enor] won Pmminerenemerne 


SMF59TSS | 8 EBCDIC | MJDXBsI | MV/BDT transaction source node 


a SMF59TUT EBCDIC MJDXTYP Transat ion source userid type: 
‘J’ — JES cdOnsole 
‘B‘ — Batch jon 
‘M’ — MCS consvle 


EO 


+56 SMF59TSU EBCDIC Transaction source usé 
MJDUSID 
MJDCNDD 
MJDBJAM 
MJDMCSI 


TSO userid 
Transaction Type Section for FTF: 
SMF590NN EBCDIC | MJDFRLOC {|MVS/BDT origin node name 


JES console DD name 
Batch job name 


MCS console identified 
+3C SMF590VI EBCDIC | MJD text unit | First volume serial number for origin file if spec 
transaction 


(Continued) 
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} | Name Lengt | Format Description 
\ 
+46N SMF59DNN | xe. | EBCDIC | MJDTOLOC MVS/BDT destination node name 
+4 | ‘SMFSQDFN| 44 _— EBCDIC| MJD text unit Destination file name if specified in transaction 


+122| +7A EBCDIC|] MJD text unit PDS member name of destination file is specified in SEQ 
transaction 

+130] +82 D ENCDIC|] MJD text unit First volume serial number for destination file is specified 
in transaction 


N 
+136} +88) SMF59DFG EBCDIC] internal 


+ | + 
~]™N 
ale 


Destination file flag: ‘D’ - DUMMY specified 





— INTRDR specified 


Transaction Data Section: \ 
+0 +0 SMF59TTQ b MJDJST Time, in hundredths of a second, transaction was queued 
x (GMT) 


+4 +4 SMF59DTQ Ne MJDJSD Date transaction was queued, in the form OOY YDDDF, where F 
is the sign (GMT) 
+8 +8 SMFS59TTC binary NJ internal Time, in hundredths of a second, transaction was completed 
\ (GMT) 
+12 | +C SMF59DTC packed Date transaction was completed, in the form OOY YDDDF, 
where F is the sign (GMT) 


aie [eo | swreoew | @_[ eecoic | waoJugnw [wvs/e0Tiep nme 


+46 | +2E SMF59TCM EBCDIC \] Transaction completion code: ‘00’ — normal 
\ ‘04’ — operator cancelled 
‘08’ — abnormal 
/+48 |+30 | smF59BTc | 8 | EBCDIC | MJDXCODE |MVS/BDT transaction code 
smrsoToi | 4 | | Rese 
+60 | +3¢ | SMF59BCT | 8 | binary | MJDBYTES | Numbehof bytes transferred 


[+68 [+44 | SMF59US1 | 40 EBCDIC | User area Ngitialized with blanks) 








Transmission Section: 












SMF59 X01 Reserved 
SMF59X02 
SMF59SNN 
SMF59X03 
SMF59X04 
SMF59X05 
SMF59RCN 
SMF59X06 
SMF59XST 









Reserved 


MVS/BDT sender nade 










EBCDIC | MJDFRLOC 










Reserved 












Reserved 






Reserved 


MVS/BDT receiver node 













EBCDIC | MJDTOLOC 






Reserved 













& © © © © © 0O© Oo @W 


MJDXST 










Time, in hundredths of a second, traysmission started 


(GMT) 
Date transmission started, in the form OOKYDDDF, where 
F is the sign (GMT) 


binary 















SMF59XSD packed MJDXSD 









MJDXPT Time, in hundredths of a second, transmission Stopped 


(GMT) 


Date transmission stopped, in the for OOYYDDDF, 
is the sign (GMT) 


SMF59XPT binary 













SMF59XPD MJDXPD here F 






packed 






Reserved 





SMF59X08 
SMF59X09 








Reserved 





6-134 System Management Facilities (SMF) 


Cc a 


SMF59XOC EBCDIC | SEFRCOMP Transmission origin completion code 
(JCT) 


+§ SMF59XDC EBCDIC | SETOCOMP Transmission destination completion code 


(JCT) 


+102 | +6 Reserved 


+104 | +68 EBCDIC User area (initialized with blanks) 








Transaction Transaction wecountings ection: (This section is optional.) 


+0 | 40 | smrsoac\ variable! EBCDIC | MJD text unit User accounting data from ACCT parameter 
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Record Type 60 (3C) — VSAM Volume Data Set Updated 


Record type 60 is written by IGGOCLED when a VSAM Volume Record (VRR) 
is inserted, updated, or deleted from a VSAM Volume Data Set (VVDS); for 
example, when a VSAM cluster is defined, closed, or deleted, one type 60 record 
is written for each VRR written or deleted. 


Record type 60 identifies the VVDS in which the VVR is written or deleted 
and gives the new, updated, or deleted VVR. It identifies the job by job log and 
user identifiers. 


The length of the record is 208 bytes plus the length of the VVR. 


The SMF record mapping macro for record types 60, 61, 65, and 66 is 
IFASMFI6. 


Its format is: 
IFASMFI6 nn 


where nn identifies the type of the record you want to map. The mapping macro 
resides in SYS1 .MACLIB. 


The format is: 


one | Neme  Jusngtt] Formet | Souwce | ~SCaripto 
fo | o | smreouen Hi; rey {rare Length of record descriptor word 
6 VS2 


SMF60SYS binary SVC 83 System indicator 
or 


SM | SMF6ORTY | | binary | Record | Recordtype sssi—‘sSSSSCS 


SMF60TME binary | SVC cue Time, in hundredths of a second, record was moved to SMF 
buffer 

SMF60DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the 5 enemy ere aaa 


| SMF6OCPU | | EBCDIC| eee System identification (taken from SID | System identification (taken from SID parameter) —_—| 


area 


ial lied SMF60SUB eal EBCDIC a parameter Contains ‘IN’ if VVR is inserted; ‘UP’ if VVR is updated: 
a 


or ‘DE’ if VVR is deleted 


SMF60POF 4 | binary _ binary Offset of product section 
Tao [ve | autreorno [2 [nay [rat ~| tur of rodent etn 
[32 [20 [ sreonor [4 | binary [internal | _Offet of data sation 
[36 [24 | smreooun [2 | binary [internal | _Langth of data section 
[ae [26 [~ swreoono | 2 | binary [intemal | Number of data section 


(Continued) 

















Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 





















6-136 System Management Facilities (SMF) 





J 


[orm teme_YLanat | Foret | Sows [Omen 


SMF60VER 7 EBCDIC Version of the type 60 record 


Tae | 20] swreorww | 8 zecoic| meme! Catalog management product identifier 
| so | 32 | smréeoinm | 8 | EBCDIC| IMRJOB 


SMF60RST binary JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job! 
SMF60RDT packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOY YDDDF where F is the sign | 
86] 42 SMF60UID a EBCDIC| JMRUSEID User identification (taken from common exit parameter 
area) 


ce [aatswreorne[ [| dee 


m/e SMF60CNM “ EBCDIC| VVDS parameter Name of VVDS in which entry is made 
list 


Tiel 77 |_swreorve [1 | eacoic| wacowre | envy tpelientiy SSS 
[ent 7a [sure enor weve | eermme 


| Reserved | 


—Seccon var- | VVR (the length of the VVR is contained in the first 2 
iable bytes of this field) 


The job name and the time and date that the reader recognized the JOB card for this job constitute the job log identification. 






Product and data section: 
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Record Type 61 (3D) — Integrated Catalog Facility Define Activity 


Record type 61 is written by IGGOCLED when an ICF catalog record is written 
during the processing of an Access Method Services DEFINE command. One type 
61 record is written for each record inserted or updated in a catalog. Record type 
61 identifies the entry being defined and the catalog in which the catalog record is 
written, and gives the new or updated catalog record. It identifies the job by job 
log and user identifiers. 


Its length is 208 bytes plus the length of the catalog record. 
For a description of the mapping macro, see Record type 60. 


The format is: 


teoeo] Format | Sowe[Cn 


oan ea SMF61LEN Length of record descriptor word 
rane SMF61SEG Record descriptor word descriptor 
6  vSs2 


SMF61SYS SVC 83 
7 VS1 


SMF61TME binary SVC 83 Time, in hundredths of asecond, record was moved to SMF 
buffer 

SMF61DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the Ig ene reer en men ay 


)  SMF61CPU | | EBCDIC|SMCASID See System identification (taken from SID | System identification (taken from SID parameter) 


ore 


baled SMF61SUB [® | EBCDIC a parameter Contains ‘IN’ if VVR is inserted; ‘UP’ if VVR is updated; 
list 

































System indicator 


Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 










or ‘DE’ if VVR is deleted 


[aa [Te | swreiPOr | 4 | binewy [internal | _Offewt of prowuctsecion 
[aa [16 | swrevecw | 2 | winery [iverat | _Langthof product ection 
[20[ 1 | swrerewo | 2 | winay [internal | Number ot product setons 
[a2 | 20 | smeeio0F | «| binary [internal | Ofte of datawction 
ras [24 | swreroL | 2 | binary [internat | Length of datasecton 
rae [ 25 | swreroNo [2 | binary [itera | Numberofdetasectong 


(Continued) 
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Torses [rome [mma] Fomer[ sow S~*~*~*~« moe 


Product and data section: 
SMF61VER EBCDIC Version of the type 61 record 


ra [2n| sursieww | [EBD mri | Gnoeg naan: ruc nian 
/s0 | 32 | smrewnm | 8 |eecpiclimrsos | Jobnemey 


3A SMF61RST binary | JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job! 
SMF61RDT packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign * 
oa a SMF61UID _ EBCDIC] JMRUSEID User identification (taken from common exit parameter 
ee 


SM | SMF61FNC | FNC | Reserved | 


+ SMF61CNM es EBCDIC ——— Name of catalog in which entry is defined 
/119| 77 | smreityp | 1 | EBCDIC| internat  —s|_Entry type identifier 


+ 


| Reserved sss—‘—sSSCid 


SM Serene CRC | var- — nary ———_— record New catalog record for defined entry (the length of this 
iable record is contained in the first two bytes of this field) 


'The job name and the time and date that the reader recognized the JOB card for this job constitute the job log identification. If 
a system task caused the record to be written, the job-name and user-identification fields contain blanks and the time and date 
fields contain zeros. 
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Record Type 62 (3E) — VSAM Component or Cluster Opened 


Record type 62 is written by IDAO192S at the successful or unsuccessful 
opening of a VSAM component or cluster. Its length is 142 bytes plus ten 
bytes for each volume listed. 


Record type 62 identifies the VSAM component or cluster and indicates whether 
it was successfully opened. It names the VSAM catalog in which the object is 
defined and the volumes on which the catalog and object are stored. It also 
identifies the job that issued the OPEN macro by job log identification and user 
identification. 


Note: This record is not generated when a system task issues the OPEN macro. 


The format is: 















internal Record length 


internal Segment descriptor 


SVC 83 System indicator 

Bit Meaning When Set 
0-4 Reserved 

5 MVS/XA 

6 VS2 

i VS1 


re 
@ 
= 
© 
a 
7 


| o | SMF62LEN | 2 


SMF62SEG | 2 


SMF62FLG 


rs swreany 


bl Bose 
om 
p12 


binary 
binary 





binary 













internal Record type 


SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 

SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


SMCASID System identification (taken from SID parameter) 


binary 
binary 


packed 


A SMF62DTE 


SMF62SID 
SMF62JBN 


EBCDIC 
EBCDIC 
binary 


IMRJOB 


JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job! 


3 ; 
JMREDATE Date reader recognized the JOB card for this Job, in the 


12 

SMF62RST 

had SMF62RSD 
2A 


3 packed 
form OOY YDDDF where F is the sign! 
SMF62U IF EBCDIC} JMRUSEID User identification (taken from common exit parameter area) 


6 
0 
4 
2 


4 


Set by IDAO0192A 
and passed to 
1DA0192S in 
parameter list 


Open status indicator 
Meaning When Set 
Component or cluster was successfully opened 


binary 


Security violation, that is, invalid password 
Record is a catalog or CRA record 

Record is for a VVDS or ICF catalog being opened 
or closed as a data set2 

Reserved 


EBCDIC}] CAXCNAM Name of the catalog in which the component or cluster is 
(in IGGCAXWA) defined 


EBCDIC|] UCBVOLI Volume serial number of the volume containing the catalog 
EBCDIC] JECBDDNM Name of the component or cluster being opened 


binary OPEN routine Number of online volumes containing the component or 
cluster. (This field is also the number of ten-byte fields 
that list the volumes.) 





: SMF62IND 


SMF62CNM 


5A SMF62CVS 
| 60 | SMF62DNM 


SMF62VCT 2 





calculates from 
VMT entries 


For each online volume, there is a ten-byte entry with the following format: 



























SMF62VSR EBCDIC] VMTVLSER Volume serial number of the volume containing the 


component or cluster 















SMF62DTY UCBTYP Unit type of the volume containing the component or 


cluster 


binary 





1The job name and the time and date that the reader recognized the JOB card for this job constitute the job log identification. 
21 this bit is set, the catalog name field and the cluster name field might be set to zeroes. 
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Record Type 63 (3F) — VSAM Entry Defined 


Record type 63 is written by IGGOCLBV when a VSAM catalog entry (a component, 
cluster, catalog, alternate index, path, or non-VSAM data set) is defined by the Define 
Access Method Service command and when that definition is altered. For example, 
when a VSAM catalog entry (1) is altered with new space allocation information (that 
is, when the VSAM End-Of-Volume EOV routine extends the entries object), or (2) 

is changed by the Alter Access Method Services command. One record type 63 is 
written for each newly created or altered entry. Its length is 136 bytes plus the length 
of the catalog records required to describe the entry. 


Record type 63 identifies the catalog in which the object is defined, gives the 
catalog record for the newly defined object, and, for an alteration, gives the parts 
of the old catalog record before they were altered. It identifies the job by job log 
identification and user identification. 


Notes: 

1. The length of this record can be from 1000 to 4000 bytes or more, depending 
upon the sizes of the new and old catalog records (offsets 44 and 46, respectively). 
If this record is to be written to the SMF data set, be sure to include the sizes of 
these catalog records when estimating the additional storage required for the SMF 


buffer and the SMF data sets. 
2. This record is not written when a VSAM catalog entry is renamed. (Record type 
68 is written in this case.) 


The format is: 


| Offsets | Name | Length | Format | Sourea | Description =, 
[0 [0 | swresten | 2 | binary Record levath 
|| 2 [smressec | 2 [binary 


| SMF63FLG binary |SVC 83 System indicator 


Bit Meaning When Set 
| 5 | 5 | smF63RTY internal 
Time, in hundredths of a second, record was moved to SMF 


0-4 Reserved 
5 MVS/XA 
binary 
buffer 
A SMF63DTE packed |SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF where F is the sign 





























VS1 










Record type 





6 VS2 
| 14 | & | SMF63SID _ EBCDIC | SMCASID System identification (taken from SID parameter) 
| 18 | 12 | SMFG3JBN EBCDIC | JMRJOB 
Time, in hundredths of a second, reader recognized the 


1A | SMF63RST binary 
JOB card for this job? 
packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOY YDDDF where F is the sign? 
Laka SMF63UIF EBCDIC | JMRUSEID User identification (taken from common exit parameter 
area) 


1The job name and the time and date that the reader recognized the JOB card for this job constitute 
the job log identification. If a system task caused the record to be written, the job-name and user- 
identification fields contain blanks and the time and date fields contain zeros. 


Job name? 





JMRENTRY 











(Continued) 
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Tories | Nene [aoe [Fomee[ sow [Centon 


| SMF63FDT aa VSAM catalog 


record entry type 
| - | 


binary Size of old catalog record. This field contains the size of 
the old records before they were altered. (Be sure to 
include the contents of this field when estimating the 
additional storage required by SMF.)2 
SMF63CNM EBCDIC} CAXCNAM Name of catalog in which the entry is defined 
(in IGGCAXWA) 
5C EBCDIC] Name field of VSAM| Entry name 
catalog record 


ye -_ 


2A VSAM catalog record is contained in one or more physical 
catalog records. Offsets 44 and 46 are the sums of the sizes 
of the physical catalog records that constitute the total logical 
VSAM catalog record. 












Record creator/entry type indicator 
Bit Meaning When Set 










0 New definition 

1 Altered definition 

2-5 Reserved 

6 Path defined or altered 

7 Alternate index defined or altered 












VSAM catalog 
record entry type 


Entry type indicator 


Bit Meaning When Set 
0 VSAM cluster 

1 VSAM data component 
2 VSAM index component 
3 VSAM catalog 

4 Non-VSAM data set 
5 

6 

7 














Generation data group 
Alias 

Reserved 
Size of new catalog record. (Be sure to include the contents 


of this field when estimating the additional storage 
required by SMF.) 






















New catalog record followed by old catalog record. 
For the new catalog record, the complete new entry is 
recorded. For the old catalog record, this field contains 
only those old records that were altered; it shows what 
these records were before they were altered. 


VSAM catalog entry 
records 










6-142 System Management Facilities (SMF) 





Record Type 64 (40) — VSAM Component or Cluster Status 


Record type 64 is written when (1) a VSAM component or cluster is closed, (2) 
VSAM must switch to another volume to continue to read or write, and (3) there 
is no more space available for VSAM to continue processing. If a cluster is closed, 
one record is written for each component in the cluster. This record is written by 
IDA0192S. Its length is 254 bytes plus 26 bytes for each extent. 


Record type 64 indicates why the record was created (a component was closed, 
another volume was switched to, or no additional space was available). It describes 
the device and volume(s) on which the object is stored, and gives the extents of the 
object on the volume(s). It also gives statistics about various processing events that 
have occurred since the object was defined, such as the number of records in the 
data component, the number of records that were inserted, and the number of 
control intervals that were split. This record identifies the job by job log 
identification and user identification. 
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The format is: 


nore [tenth [Format| Sows] Dewritow 
PS oe ee sec fae ree 
Ee || | 2 |SMF64SEG | 2 [binary internal Segment descriptor 


SMF64FLG binary ere 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
: VS2 
VS1 


Ts [8 |swreanty| 1 [vinary [inwernat | Recordtype SOS 


SMF64TME binary |SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 
10 SMF64DTE packed |SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


| 4 | EBCDIC ISMCASID System identification (taken from SID | System identification (taken from SID parameter) = 


SMF64RST binary JMRENTRY Time, in hundredths of a second, reader recognized the JOB 
card for this job 

SMF64RSD packed |JMREDATE Date reader recognized the JOB card for this job, in the 

form OOY YDDDF where F is the sign? 












0 
1 
2 
3 
4 
5 
6 
7 





























Number of tracks that were requested but could not be 
allocated 











SMF64U IF EBCDIC | JMRUSEID User identification (taken from common exit parameter 
area) 
binary Situation indicator 
Bit Meaning When Set 
Component closed 
Volume switched 
No space available 
Record is a catalog or CRA record 
Component closed, TYPE=T 
Record written during ABEND processing 
Record is for a VVDS or ICF catalog being opened 
or closed as a data set2 
Reserved 
SMF64DTY binary |AMBTYPE Indicator of component being processed 
Bit Meaning When Set 
0 Data component 
1 Index component 
2-7 Reserved 
2C |SMF64CNM EBCDIC | CAXCNAM Name of the catalog in which the component is defined 
(in IGGCAXWA) 
88 EBCDIC | VSAM catalog Name of the component or cluster being processed. For 
(ENTNAME) a CRA record, this field does not contain meaningful 
information. For a catalog record, this field contains 
the catalog or cluster name. 
SMF64NTR binary VSAM catalog 
(PRIMSPAC for 
primary allocation; 
SCONSPAC for 
secondary allocation) 
binary | ARDHRBA Highest used relative byte address (RBA) of the component 
(in ARDB) 
ga |SMFe64EsL | | 2 | binary | DEBNMEXT * |DEBNMEXT * 26 | Length of extent entry portion of record, excluding this field of extent entry portion of record, excluding this field 
= job name and the time and date that the reader recognized the JOB card for this job constitute the job log identification. 
2if this bit is set, the catalog name field and the cluster name field might be set to zeroes. 
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J 





2 


C 


SMF64FCC 


SMF64TCC 


SMF64VSN 


SMF 64CUU 
SMF64IND 


EBCDIC | UCBVOLI 


UCBCHAN 
internal 


Description 


Beginning cylinder and track, in the form CCHH where CC 
is the cylinder number and HH is the track number 


Ending cylinder and track, in the form CCHH where CC is 


the cylinder number and HH is the track number 


Volume serial number of the volume containing the extent 


Device number 
Spindle identification 





+18 SMF64UTY binary UCBTYP Unit type 
+22 SMF64RV1 binary Reserved 


Statistics Section: 3 


Accumulative Statistics from Creation Until the Current OPEN: 


+0 

+4 

+8 

+12 
+16 
+20 
+24 
+28 
+32 
+36 


+40 
+44 


Change in Statistics from OPEN to Time of EOV and CLOSE: 


+48 
+52 
+56 


+60 


+64 


+68 


+72 


+76 


+80 


+84 


+88 


SMF64SLN 

SMF64NIL 

SMF 64NEX 
SMF64NLR 
SMF64NDE 
SMF64NIN 

SMF64NUP 
SMF64NRE 
SMF64NFS 
SMF64NCS 


SMF64NAS 
SMF64NEP 


SMF64DIL 
SMF64DEX 
SMF64DLR 


SMF64DDE 


SMF64DIN 


SMF64DUP 


SMF64DRE 


SMF64DFS 


SMF64DCS 


SMF64DAS 


SMF64DEP 


4 


- h hh hf Hh Sh SF A 


4 
4 


4 
4 
4 


4 


binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


binary 
binary 


binary 
binary 
binary 


binary 


binary 


binary 


binary 


binary 


binary 


binary 


binary 


internal 
AMDNIL 
AMDNEXT 
AMDNLR 
AMDDELR 
AMDIREC 
AMDUPR 
AMDRETR 
AMDASPA 
AMDNCIS 


AMDNCAS 
AMDEXCP 


AMDNIL 
AMDNEXT 
AMDNLR 


AMDDELR 


AMDIREC 


AMDUPR 


AMDRETR 


AMDASPA 


AMDNCIS 


AMDNCAS 


AMDEXCP 


Length of the statistics section, including this field 
Number of levels in the index 

Number of extents 

Number of records in the component 


Number of records that were deleted from the component 


Number of records that were inserted into the component 


Number of records that were updated in the component 


Number of records that were retrieved from the component 
Number of unused control intervals in the component 


multiplied by the control interval size 
Number of control intervals that were split in the 
component 


Number of control areas that were split in the component 


Number of EXCPs. (For more information about EXCP 


count, see Chapter 8.) 


Change in number of levels in the index 
Change in number of extents 


Change in number of records in the component. The 


field may be negative. 


Change in number of records that were deleted from the 


component 


Change in number of records that were inserted into the 


component 


Change in number of records that were updated in the 


component 


Change in number of records that were retrieved from the 


component 

Change in number of unused control intervals in the 
component rultiplied by the control interval size. 
(This field may be negative.) 


Change in number of control intervals that were split 


in the component 


Change in number of contro! areas that were split in the 
component 


Change in number of EXCP. (For more information 
EXCP count, see Chapter 8.) 





2These fields are zero for DD*, DD DATA, DD DUMMY and spooled data sets. 


3 All the fields in this section are present and are taken from the AMDSB 


data area; inapplicable fields contain zeros. 
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ere [tne [onwn| forme] owe [ee 


Data Set Characteristics Section: 
SMF64DBS 




















LPMBLKSZ 
(in IDALPMB) 


AMDCINV 
(in AMDSB) 


AMDLRECL 
(in AMDSB) 


AMDKEYLN 
(in AMDSB) 


TIOEDDNM 


binary Physical block size 












SMF64DCI binary Control interval size 








SMF64DLS 








binary Maximum logical record size 








SMF64DKL binary Key length 
















SMF64DDN EBCDIC DD name. When the record is written for a VSAM catalog 
or catalog recovery area, this field may contain zeros. When 
the record is written for a volume switch or no space 
available condition, and the volume is associated with a 


concatenated TIOT entry, this field contains blanks. 
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Record Type 65 (41) — Integrated Catalog Facility Delete Activity 


Record type 65 is written by IGGOCLED when an ICF catalog record is written or 
deleted during the processing of an Access Method Services DELETE command. 
One type 65 record is written for each record updated or deleted from a catalog. 
Record type 65 identifies the entry being deleted and the catalog in which the 
catalog record is updated or deleted, and gives the updated or deleted catalog 
record. It also indicates whether a VSAM cluster or non-VSAM data set was 
scratched (function indicator = ‘S’), or only catalog information was deleted 
(function indicator = ‘U’). It identifies the job by job log identification and user 
identification. Its length is 208 bytes plus the length of the catalog record. 


For a description of the mapping macro, see record type 60. 


The format is: 


aes Sore = 


SMF65SYS binary SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
: VS2 
VS1 


res saeeeny [1 ners [iene Recor wpe 


SMF65TME binary SVC 83 Time, in hundredths of a second, record was moved to SMF 
buffer 

SMF65DTE packed |SVC83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 


SS SMF65CPU —— EBCDIC | SMCASID System identification (taken from SID parameter) 
a a” 


ila SMF65SUB Pers [2 EBCDIC | VVDS parameter | Contains ‘IN’ if VVR is inserted; ‘UP’ if VVR is updated; or 
list 


‘DE’ if VVR is deleted 


/ 18 | SMF65POF | 4 | binary | | binary | Offset of product section 
ote ae ee Length of product section 
Sie wel sie ee 
/32 | 20 | smrespor | 4 | binary |internai_——_—|[ Offset of datasection 
rae [24 [ swresoun | 2 | binary |internal | Length of datasection 
(38 | 26 | sMF6sDNo| 2 | binery [internal | Number of datasections 
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Product and data section: 















SMF65VER x EBCDIC Version of the type 65 record 


Pa srr EBCDIC Catalog + Saeea product identifier 
/50 | 32 | smresinm | 8 | EBCDIC|JMRJOB pJobname$ 


SMF65RST binary JMRENTRY Time, in hundredths OF a second, reader recognized the 
JOB card for this job! 

SMF65RDT packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign | 


ac SMF65FNC sere PT ao Contains ‘S‘ if a data set was scratched; ‘U’ if only catalog 


entries were modified 
| 75 | 48 | SMFe5CNM| 44 | EBCDIC|CAXCNAM Name of catalog in which record was updated or deleted 
/119| 77 | smrestyp | 1 | EBCDIC Entry type identifier 


list 


ptea| aa | smresnnm| 446 | || Reserved 
SMF65CRC | var- binary Catalog record Catalog record for updated or deleted entry (the length of 
iable this record is contained in the first two bytes of this field) 

'The job name and the time and data that the reader recognized the JOB card for this job constitutes the job log identification. If 


a system task caused the record to be written, the job name and user identification fields contain blanks and the time and date 
fields contain zeroes. 
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Record Type 66 (42) — Integrated Catalog Facility Alter Activity 


Record type 66 is written by IGGOCLED when an ICF catalog record is written or 
deleted during the processing of an Access Method Services ALTER command or 

a data set extend operation. One type 66 record is written for each record written 

or deleted from a catalog. Record type 66 identifies the entry being altered and the 
catalog in which the catalog record is written or deleted, and gives the new, updated, 

or deleted catalog record. It also indicates if the entry was renamed (function indicator = 
‘R’) and, if so, gives the old and new names of the entry. It identifies the job by job 

log identification and user identification. Its length is 208 bytes plus the length of the 
catalog record. 


For a description of the mapping macro, see record type 60. 





















The format is: 
| offeets | Name |uength| Formet | Source | Description = 
rare smresten | 2 | binary | internal ___|_Langth of record detrintor word 
SMF66SYS binary |SVC83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
5 MVS/XA 
6 VS2 
0 
fae. jie. | SMF66RTY | 1 | binary | internal =| Record |Recordtype = es  s—i‘—sCid 
SMF66TME binary |SVC 83 Time, in hundredths of asecond record was moved to SMF 
buffer 
SMF66DTE packed |SVC 83 Date record was moved to SMF buffer, in the form 
OOYY DDDF where F is the sign 
) 14] € |  SMF66cPU | 4 | EBCDIC|SMCASID —_| System identification (taken from SID parameter) 
[18[ 12| smreesss | 4 | [| i Reserve 
SMF66SUB EBCDIC | VVDS parameter Contains ‘IN’ if VVR is inserted; ‘UP’ if VVR is updated; 
"ae or ‘DE’ if VVR is deleted 
| 24] 18 | SMF66POF ee ieee | internal =| Offset of product section 
a0 [ve | SMresPNo | 2 | binary internat | Number of product sections 
[a6 [24 | SMFOGDLN| 2 | binary internal | Length of data section 
(Continued) 
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Product and data section: 
SMF66VER EBCDIC Version of the type 66 record 


aint aan EBCDIC [internal __—_‘{_ Catalog management product identifier 
50 | 32. SMF66JNM eo | EBCDIC | JMRJOB Job name! 


3A SMF66RST binary |JMRENTRY Time, in hundredths a a second, reader recognized the 
JOB card for this job! 
SM —| DT packed |JMREDATE Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign | 
Galle SMF66UID i | EBCDIC | JMRUSEID User identification (taken from common exit parameter 
area) 


| SMF66FNC — / 1 | EBCDIC internal Contains ‘R’ if catalog entry is renamed 


Ps [| ero SMF66CNM a EBCDIC | CAXCNAM Name of catalog in which entry is updated or deleted 
| SMF66TYP | | 1 | EBCDIC /EBCDIC|internal Entry type identifier 


Ee BE Fa Catalog parameter Sa entry name 
list 
list 


SMF66CRC var- binary Catalog record Catalog record for updated or deleted entry (the length of 
iable this record is contained in the first two bytes of this field) 


‘The job name and the time and date that the reader recognized the JOB card for this job constitutes the job identification. Ifa 
system task caused the record to be written, the job name and user identification fields contain blanks and the time and data fields 
contain zeroes. 
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Record Type 67 (43) — VSAM Entry Deleted 


Record type 67 is written by IGGOCLBV when a VSAM catalog entry (a component, 
cluster, catalog, alternate index, path, or non-VSAM data set) is deleted. A type 63 
record is written for each entry affected by the DELETE Access Method Services 
command. For example, three records are written for an indexed cluster: one for 
the relationship between the components of the cluster, one for the data component, 
and one for the index component. Its length is 134 bytes plus the length of the 
catalog records required to describe the entry. 


Record type 67 identifies the deleted entry, the VSAM catalog in which the entry 
was defined, and the deleted catalog records. It identifies the job by job log 
identification and user identification. 


Notes: 

1. The length of this record can be from 1000 to 4000 bytes or more, depending 
upon the sizes of the catalog records that describe the entry (offset 132). If this 
record is to be written to the SMF data set, be sure to include the sizes of these 
catalog records when estimating the additional storage required for the SMF 
buffer and the SMF data sets. 


The format is: 


[ores [Nene [teen [ Forme] Soe [ero 
SH SMF67LEN | 2 | binary internal |—Record length 


SMF67FLG binary |SVC 83 System indicator 
Bit Meaning When Set 
0-4 Reserved 
MVS/XA 
VS2 
VS1 


| SMF6E7RTY | F6E7RTY | 4 | binary | Record type 


SMF67T ME binary SVC jcoree Time, in hundredths of a second, record was moved to 
SMF buffer 
SMF67DTE packed |SVC 83 Date record was moved to SMF buffer, in the form 
OOYYDDDF where F is the sign 
ae SMF67S!D Pa | EBCDIC | SMCASID System identification (taken from SID parameter) 


1A | SMF67RST binary | JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job? 
SMF67RSD packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOY YDDDF where F is the sign? 
ae SMF67UIF a EBCDIC | JMRUSEID User identification (taken from common exit parameter 
area) + 


2A | SMF67FDT binary VSAM catalog Record creator/entry type indicator 
record entry type Bit Meaning When Set 
0 Uncataloged* 
1 Scratched@ 
2-5 Reserved 
6 Path deleted 
7 Alternate index deleted 


1The job name and the time and date that the reader recognized the JOB card for this job constitute the job log (Continued) 
identification. If a system task caused the record to be written, the job-name and user-identification fields contain 
blanks and the time and date fields contain zeros. 

2Both indicators are set for VSAM component or cluster entries. For all other VSAM entries, only the uncataloged bit is set. 
For non-VSAM entries, the uncatalog bit is always set and the scratched bit is set if the physical non-VSAM space was deleted. 
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NOOfh WN O 


record entry type Bit Meaning When Set 
VSAM cluster 

VSAM data component? 

VSAM index component? 

SMF67CNM CAXCNAM Name of catalog in which the entry was defined 
(in IGGCAXWA) 

SMF67DEN Name field of VSAM/| Entry name 
catalog record 
SMF67RSZ binary | internal Size of catalog record that defined the entry.* (Be sure ta 
include the contents of this field when estimating the 
additional storage required by SMF.) 
SMF67CRC | variable | binary | VSAM catalog Catalog record* 
entry records 


VSAM catalog 
Non-VSAM data set 
3 data or index component can only be deleted as one of the three catalog 
records deleted when a cluster is deleted. 


Generation data group 
4A VSAM catalog record is contained in one or more physical catalog records. 


[orate [ame [Usnath [Porm] Source [Demin 
Alias 
Offset 132 is the sum of the sizes of the physical catalog records that constitute 


SMF67IOD binary |VSAM catalog Entry type indicator 
Reserved 
the total logical VSAM catalog record. 
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Record Type 68 (44) — VSAM Entry Renamed 


Record type 68 is written by IGGOCLBV when a VSAM catalog entry (a component, 
cluster, catalog, alternate index, path, or non-VSAM data set) is renamed using the 
ALTER Access Method Services command. This record identifies the VSAM catalog 
in which the object is defined, and gives the old and new names for the object. It 
also identifies the job by job log identification and user identification. Its length is 
174 bytes. 


The format is: 


ces ee Description 
pen ee ae — 
[2 [smressec | 2 [inary [internet | “Seament descriptor 


il SMF68FLG al SVC 83 System indicator 


Bit Meaning When Set 

0-4 Reserved 
Cs [8 | swreanry| 1 [binary [internat | _Record type 
binary |SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 
SMF68DTE packed |SVC 83 Date record was moved to SMF buffer, in the form 

OOYYDDDF where F is the sign 

(14 [ E | SMF68S!ID }EBCDIC|SMCASID si System a (taken from SID parameter) 

[18] 12_| SMF6BIBN ae IMRJOB 


SMF68RST binary | JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job? 
SMF68RSD packed | JMREDATE Date reader recognized the JOB card for this job, in the 
form OOYYDDDF where F is the sign? 
SMF68UIF JMRUSEID User identification (taken from common exit parameter 
area)? 
CAXCNAM Name of catalog in which the entry is defined 
(in IGGCAXWA) 


SMF680NM Pointed to by Old name of the entry. (AMS obtains this name from the 
CTGFVENT field in | ALTER command.) 
IEZCTGFV | 
parameter list 
“eee pe ri 


CTGNEWNM field 

in lEZCTGPL 
parameter list 

1The job name and the time and date that the reader recognized the JOB card for this job constitute 

the job log identification. If a system task caused the record to be written, the job-name and user- 

identification fields contain blanks and the time and date fields contain zeros. 


















5 MVS/XA 
: VS2 
VS1 

































New name of the entry. (AMS obtains this name from the 
ALTER command.) 
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Record Type 69 (45) — VSAM Data Space Defined, Extended, or Deleted 


Record type 69 is written by IGGOCLBV when a VSAM data space is defined, 
extended, or deleted using the DEFINE or DELETE Access Method Services 
commands. Record type 69 is not written when a catalog or a unique data set is 
defined or deleted. Its length is 106 bytes. 


This record identifies the catalog in which the data space is defined and the 
volume on which it is (or was) allocated. It also gives the number of free data 
space extents and the amount of unallocated space on the affected volume after 
the definition, extension, or deletion. It identifies the job by job log identification 
and user identification. 


The format is: 


ee a aes 
ee a 
[2-|smressec [2 [binary internal | Segment descriptor 


SMF69FLG SVC83 System indicator 
VS1 


Bit Meaning When Set 
rs [S| swreonry [1 [binary internal «| “Records SOS 


0-4 Reserved 

SMF69TME binary SVC 83 Time, in hundredths of a second, record was moved to 
SMF buffer 

SMF69DTE packed |SVC 83 Date record was moved ta SMF buffer, in the form 
OOY YDDDF where F is the sign 


| SMFe9siID | 4 | EBCDIC |SMCASID System scealillslh (taken from SID parameter) 
he SMF69JBN | 8 | EBCDIC | JMRJOB 


1A SMF69RST binary |JMRENTRY Time, in hundredths of a second, reader recognized the 
JOB card for this job? 
SMF69RSD packed |JMREDATE Date reader recognized the JOB card for this job, in the 
form OOY YDDDF where F is the sign? 
eee EBCDIC | JMRUSEID User identification (taken from common exit parameter 
area) 1 


EXCP of sense data Spindle identification 


binary | VSAM catalog Number of free data space extents on the affected volume 
volume entry after the data space is defined, extended, or deleted 
SMF6SNUC binary | VSAM catalog Number of unallocated cylinders in all of the data spaces 
volume entry on the volume 
SMF69NUT binary |VSAM catalog Number of unallocated tracks in all of the data spaces on 
volume entry the volume in addition to the number of unallocated 
cylinders 
SMF69LNC binary |VSAM catalog Number of cylinders in the largest continuous unallocated 
volume entry area in any data space on the volume 
SMF69LNT binary |VSAM catalog Number of tracks (in addition to the number of cylinders) 
volume entry in the largest continuous unallocated area in any data space 
on the volume 
CAXCNAM Name of catalog in which the data space is defined 
(in IGGCAXWA) 
SMF69VSR EBCDIC |Name field of VSAM| Volume serial number of the volume on which the data 
catalog volume entry| space is defined 


1The job name and the time and date that the reader recognized the JOB card for this job constitute the job log identification. 
if a system task caused the record to be written, the job-name and user-identification fields contain blanks and the time and 
date fields contain zeros. 


5 MVS/XA 
: VS2 
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Record Type 70 (46) — CPU Activity 


Record type 70 is written by ERBMFDCP for each measurement interval and when 
the session is terminated. It contains data that identifies each processor, its status, 
the amount of wait time that has taken place during an RMF reporting interval, 
and data describing address space utilization during an interval, as well as I/O inter- 
ruption measurements. Its length is 635 bytes plus 24 bytes for each processor 


included. 


The SMF record mapping macro for all records produced by RMF is: ERBSMFR. 
Its format is: ERBSMFR (nn(nn,. . .)) where nn identifies the types of the records 
you want to map. Note that the parentheses are required only when two or more 

record types are specified. The mapping macro resides in SYS1.RMFMACO1. 











| Offsets | Name [Length | Format | Source | Description 
po [oo | sme7oren | 2 | binary | internal | Record length 
.2 | 2 | smrvosec | 2 | binery | internal | Segment descriptor 


SMF70FLG binary SMFWTM service System indicator 
eres Bit Meaning When Set 
0 A subsystem ID follows the standard header; 
record is in relocatable format 
Reserved 
MVS/XA 
VS2 
Reserved 


ee a 


SMF70TME binary SMFWTM service Time, in hundredths of a second, record was moved to 
routine SMF buffer 
A SMF 70DTE packed SMFWTM service Data Record was moved to SMF buffer, in the form 
routine OOyyddGdF, where F is the sign 


Tia [=| swerosio [4 | €8c0i6[ swcasiO | System identification (taken from SID paramever) 
rie 12] swrvossi_ [| e8CDIC| imerne! | Subsystem identification (RMF) 
Ta [ 16 | swerosty [2 | binary [ tnveret | Record abet 
T24[ 1] swevovaN [2 | binary | internet | Number of wiplewin tisrecordh 
rast al 2 binry [i Ree 
Tze [ic] swr7oens | «| binary | imme | Offer toAMF productamction 
Taz] 20] swrvoent [2 | binary | internat | Length of AMF product ection 
Tae [22 | smevoran [2 | inary | incernat | Number of AMF product wetions 
Tae [24 | smeroces [4 | inary | internat | Offer to CPU convrotvection 
[a0 28 | smeroce | 2 | vinary | internat | Length of CPU convrlsection 
[a2 [2a] swrvoccn | 2 | binary | internat | Number of GPU coneral ection 
Tae [2c] sweroces | 4 | binary | invernal | Offer vo CPU date section SOS~S 
Tae [20 | smrvocen [2 | binary | invernat | Length of CPU data ection 
Tso] 22] swerocen [2 | inary | invernat | Number of CPU data wctions in hinvecord 
rsa [ae | smrvonss | 4 | binary | internat | Offer vo ASID date section 
Tse | se | swrroast [2 | binary | internat | Length of ASID deta section SCS 
Pee [sa [—smrvoasn [2 | inary | innernat | Number of ASID data sections SSCS 


TA triplet is a set of offset/length/number values that defines a section of the record. 
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[ovina [Nene | terath] Format [Sowee [SSC rnin 


RMF Product Section: 
0 0 SMF 70MFV 2 RMF version number. The contents of this field can be 
any one of the following: 
EDCDIC | internal — X’FOF1’ for MF/1 
X‘FOF2’ for RMF Version 1 
X‘FOF3’ for RMF Version 2, Release 1 or 2 
X’FOF4’ for RMF Version 2, Release 2 with 
MVS/System Extensions Release 1 installed 
X'FOFS’ for either of the following: 
— RMF Version 2, Release 2 with MVS/System 
Extensions Release 2 installed 
— RMF Version 2, Release 3 
X‘FOF6’ for RMF Version 2, Release 3 when either 
MVS/System Product-JES2 Release 1 Support Feature 
(5740/XYZ) or MVS/System Product—JES3 Release 1 
Support Feature (5740-XYN) is installed 
X’FOF7’ for RMF Version 2, Release 4 
X’FOFS8’ for RMF Version 2, Release 4 Enhancements 
X‘F3F1’ for RMF Version 3, Release 1 
X'F3F2’ for RMF Version 3, Release 2 


packed internat —- X'321F’ for RMF Version 3, Release 2 Modification 
Level 1 
— X‘330F’ for RMF Version 3, Release 3 


For more information on the use of RMF, see Resource 
















Measurement Facility (RMF) Reference and User’s Guide. 

SM70DAT packed Date RMF measurement interval started, in the form 
OOyydddF, where F is the sign 

SMF 70INT packed internal Duration of RMF measurement interval, in the form 
ment interval is the sum of the recorded start time and 
this field.) 

SFM70SAM binary internal (Set by Number of RMF samples 

ERBM anemia 
[aac] swrvonva [2 [eine | | Reed 

SMF70RLS CVTRELNO Operating system release number and level, in the form 

nnil 
24 SMF70CYC internal Sampling cycie length, in the form OOOttttF, where F is 


SMF 70IST packed internal Time RMF measurement interval started, in the form 

OhhmmssF, where F is the sign 

mmsstttF, where F is the sign. (The end of the measure- 

[a [re | swrrowrt [2 [einary [overat[Record maincanance ngietor 

SMF 70FLA binary Flags 

Bit Meaning When Set 

0 Used internally by RMF post processor 

1-15 Reserved 

the sign. 


























40 28 SMF70MVS MVS software level (consists of an acronym and the 


version, release, and modification level numbers) 





EBCDIC | CVTPRODN 


SMF70IML 





CSDIOML Indicates the type of processor complex on which data 


measurements were taken 


Value Meaning 

01 308x or 908x processor 
02 4381 processor 

03 3090 processor 


49 31 SMF70PRF 


50 | 52 





X’80’ indicates the system has extended storage 
Reserved 


internal 
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S 


wy 


[“ortess [Name [ teogth | Formas [Source [SSC anion 


CPU Control Section: (continued) 
SMF70MOD packed CVTMDL Signiess CPU model number 


+2 SMF70VER binary internal CPU version number — meaning varies with model 
number 
| a Md 


CPU Data Section: Data is not collected for processors that were offline at the end of the measurement interval or that had any 
reconfiguration activity during the interval. 


SMF 70WAT 






















LCCAWTIM (Set 
by ERBMFDCP 


CPU wait time, where bit 51 = 1 microsecond. That is, 
the amount of time that the CPU is not executing 
instructions (PSW wait state bit is on). Note: Data 
could be invalid if aSET CLOCK occurred during the 
RMF intarval. 


+10 | +A SMF 70CNF binary internal Configuration activity indicator 

Bit Meaning When Set 

0-4 Reserved 

5 CPU reconfigured during post processor duration 
interval 

CSOMICP 6 CPU reconfigured during the measurement interval. 
Data for this CPU is invalid 
SMF70STA CSDOCPUAL CPU online at end of interval 


SN 
THz [re _[smr7asen [2 [packed | POCAPIO | CPU erat number (@ hexadecimal don) 
Tas [oF | swrvonve | 1 [oiney [i Rene 


+16 | +10 SMF70SLH binary PCCASLIH Number of entries to the |/O SLIH; number of |/O 
interruptions that this processor handled by entry 
into the |/O interrupt handler. 

+20 | +14 SMF7OTPI binary PCCASTPI Number of TP! with CC=1; number of |/O inter- 
ruptions that this processor handled as a resuit 
of issuing the TPI instruction. 

SM70VFS sive. PSACROSV Number of samples where the vector bit in the PSA image 

was on. | 


+28 | +1C SMF70V binary internal Vector configuration. 
SMF70VFON Bit Meaning when set 
0 Vector was online 
1-7 Reserved. 


(continued ) 













SMF 70VAC 
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ASID Data Area Section: 


0 


12 
16 
20 


BFSanvs&ESSBSRSBA 


72 


74 
76 


84 


92 
96 

100 
104 
108 
112 
116 
120 
124 
128 
130 
132 
136 
140 
144 
148 
152 
156 
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0 


& £€&SRBERBAB 


iS 
> 


SBR BAGRERSGA| 


74 
78 


BRERBS 


8C 


94 
98 
9C 


System Management Facilities (SMF) 


SMF70RMN 


SMF70RMM 
SMF70RTT 
SMF70ROO0 
SMF 70RO1 
SMF 70RO2 
SMF 70RO3 
SMF 70RO04 
SMF70RO5 
SMF70RO6 
SMF 70 RO7 
SMF 70RO8 
SMF70RO9 
SMF70R10 
SMF70R11 
SMF 70R12 
SMF70R13 
SMF70R14 
SMF70R15 


SMF70IMN 


SMF70IMM 
SMF70ITT 
SMF 70100 
SMF70101 
SMF70!02 
SMF70103 
SMF70104 
SMF7010S 
SMF70106 
SMF70107 
SMF70108 
SMF70!109 
SMF 70110 
SMF70!11 
SMF700MN 
SMF700MM 
SMF 700TT 
SMF700°0 
SMF70001 
SMF70002 
SMF70003 
SMF70004 
SMF70005 


a hH hH RH Hh Hh Hh Hh Hh Hh Sh & HR hh H Fh FS N 


N 


2 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
4 
2 
2 
4 
4 
4 
4 
4 
4 
4 


internal 
(Set by ERBMFECP) 


internal 
(Set by ERBMFECP) 


Ready minimum value over interval 


Ready maximum value over interval 
Ready total value over interval 
Count of times ready value was 0 
Count of times ready value was 1 
Count of times ready value was 2 
Count of times ready value was 3 
Count of times ready value was 4 
Count of times ready vaiue was 5 
Count of times ready vaiue was 6 
Count of times ready value was 7 
Count of times ready value was 8 
Count of times ready vaiue was 9 
Count of times ready vaiue was 10 
Count of times ready value was 11 
Count of times ready value was 12 
Count of times ready value was 13 


Count of times ready value was 14 


Count of times ready vaiue was 15 or more 


IN users minimum over interval 


IN users maximum over interval 

IN users total value over interval 
Count of times IN users was 0 
Count of times IN users was 1 or 2 
Count of times IN users was 3 or 4 
Count of times IN users was 5 or 6 
Count of times IN users was 7 or 8 
Count of times IN users was 9 or 10 
Count of times IN users was 11 - 15 
Count of times IN users was 16 - 20 
Count of times IN users was 21 - 25 
Count of times IN users was 26 - 30 
Count of times IN users was 31 - 35 


Count of times IN users was 36 or more 


Out users minimum over interval 
Out users maximum over interval 
Out users total value over interval 
Count of times out users was 0 
Count of times out users was 1 or 2 
Count of times out users was 3 or 4 
Count of times out users was 5 or 6 
Count of times out users was 7 or 8 
Count of times out users was 9 or 10 





(continued ) 





ASID Data Area Section: (continued) 


160 
164 
168 
172 
176 
180 
184 
186 
188 
192 
196 
200 
204 
208 
212 


216 
220 


224 
228 
232 
236 
240 
242 
244 
248 
252 
256 
260 
264 
268 
272 
276 
280 
284 
288 
292 
296 
298 
300 
304 
308 
312 
316 
320 
324 


AO 
A4 
A8 
AC 
BO 
B4 
B8 
BA 
BC 
Co 
C4 
C8 
CC 
DO 
D4 
D8 
DC 


EO 
E4 
ES 
EC 
FO 
F2 
F4 
F8 
FC 
100 
104 


13C 
140 
144 


SMF 70006 
SMF 70007 
SMF 70008 
SMF 70009 
SMF70010 
SMF700 11 
SMF 70WMN 
SMF 70WMN 
SMF70WTT 
SMF 70W00 
SMF70W01 
SMF70W02 
SMF 70W03 
SMF 70W04 
SMF 70W05 


SMF 70W06 
SMF 70W07 


SMF 70W08 
SMF 70W09 
SMF 70W10 
SMF 70W11 
SMF 70BMN 
SMF70BMM 
SMF 70OBTT 
SMF 70B00 
SMF70B01 
SMF 70B02 
SMF 70B03 
SMF 70804 
SMF 70B05 
SMF 70B06 
SMF70B07 
SMF 70B08 
SMF 70B09 
SMF70B 10 
SMF70B11 
SMF70SMN 
SMF70SMM 
SMF70STT 
SMF 70S00 
SMF70S01 
SMF70S02 
SMF 70S03 
SMF70S04 
SMF70S05 


4 


&’ fh Sf fh hf h hh A NN SF Hh HAH DB A 


bh hbh hb hh ANH ND FB HB Hh BP & hk hk fF Hh hk AN ND A HD BD A 


binary 


binary 


internal 
(Set by ERBMFECP) 


internal 
(Set by ERBMFECP) 





Count of times out users was 11 - 15 
Count of times out users was 16 - 20 
Count of times out users was 21 - 25 
Count of times out users was 26 - 30 
Count of times out users was 31 - 35 
Count of times out users was 36 or more 
Wait user minimum over interval 
Wait users maximum over interval 
Wait users total value over interval 
Count of times wait users was 0 
Count of times wait users was 1 or 2 
Count of times wait users was 3 or 4 
Count of times wait users was 5 or 6 
Count of times wait users was 7 or 8 
Count of times wait users was 9 or 10 


Count of times wait users was 11 - 15 
Count of times wait users was 16 - 20 


Count of times wait users was 21 - 25 
Count of times wait users was 26 - 30 
Count of times wait users was 31 - 35 
Count of times wait users was 36 or more 
Batch users minimum over interval 
Batch users maximum over interval 
Batch users total value over interval 
Count of times batch users was 0 

Count of times batch users was 1 or 2 
Count of times batch users was 3 or 4 
Count of times batch users was 5 or 6. 
Count of times batch users was 7 or 8 
Count of times batch users was 9 or 10 
Count of times batch users was 11 - 15 
Count of times batch users was 16 - 20 
Count of times batch users was 21 - 25 
Count of times batch users was 26 - 30 
Count of times batch users was 31 - 35 
Count of times batch users was 36 or more 
Started users minimum over interval 
Started users maximum over interval 
Started users total value over interval 
Count of times started users was 0 
Count of times started users was 1 or 2 
Count of times started users was 3 or 4 
Count of times started users was 5 or 6 
Count of times started users was 7 or 8 
Count of times started users was 9 or 10 
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ASID Data Area Section: (continued) 


328 
332 
336 
340 
344 
348 


412 
416 


420 


424 


428 


432 


é 


3 


é 
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148 
14C 
150 
154 
158 
15C 
160 
162 
164 
168 
16C 
170 


1A4 


1A8 


1AC 


1BO 


1B4 


1B8 


1BC 


1C8 


1CC 


SMF70S06 
SMF 70S07 
SMF 70S08 
SMF70S09 
SMF70S10 
SMF70S11 
SMF70TMN 
SMF 70TMM 
SMF 70TTT 
SMF 70T00 
SMF70T0O1 
SMF 70T02 
SMF70TO3 


SMF70T04 
SMF70T05 
SMF 70T06 
SMF70T07 
SMF 70T08 
SMF 70TO9 
SMF70T10 
SMF70T11 
SMF70LMN 
SMF70LMM 
SMF7OLTT 
SMF 70L00 


SMF70L01 


SMF 70L02 


SMF 70L03 


SMF 70L04 


SMF70L05 


SMF70L06 


SMF 70L07 


SMF 70L08 


SMF70L09 


SMF70L10 


SMF70L11 


4 


> bhhR Pe PNYN NY FR HP FP A A 


be AN NY SF FP A HR SP HSH DH A 


binary 


binary 


System Management Facilities (SMF) 


internal 
(Set by ERBMFECP' 


internal 
(Set by ERBMFECP) 


Count of times started users was 11 - 15 
Count of times started users was 16 - 20 
Count of times started users was 21 - 25 
Count of times started users was 26 - 30 
Count of times started users was 31 - 35 
Count of times started users was 36 or more 
TSO users minimum over interval 

TSO users maximum over interval 

TSO users total value over interval 
Count of times TSO users was 0 

Count of times TSO users was 1 or 2 
Count of times TSO users was 3 or 4 
Count of times TSO users was 5 or 6 


Count of times TSO users was 7 or 8 
Count of times TSO users was 9 or 10 
Count of times TSO users was 11 - 15 
Count of times TSO users was 16 - 20 
Count of times TSO users was 21 - 25 
Count of times TSO users was 26 - 30 
Count of times TSO users was 31 - 35 
Count of times TSO users was 36 or more 


Logical ready users minimum over interval 


Logical ready users maximum over interval 


Logical ready users total value over interval 


Count of times the number of logical ready 
users was 0 


Count of times the number of logical ready 
users was 1 or 2 


Count of times the number of logical ready 
users was 3 or 4 


Count of times the number of logical ready 
users was 5 or 6 


Count of times the number of logical ready 
users was 7 or8 


Count of times the number of logical ready 
users was 9 or 10 


Count of times the number of logical ready 
users was 11-15 


Count of times the number of logical ready 
users was 16 - 20 


Count of times the number of logical ready 
users was 21 - 25 


Count of times the number of logical ready 
users was 26 - 30 


Count of times the number of logical ready 
users was 31 - 35 


Count of times the number of logical ready 
users was 36 or more 
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ASID Data Areas Section: (continued) 


464 
466 
468 


1D0 
1D2 
1D4 
1D8 


1DC 


1E0 


1E4 


1E8 


1EC 


1FO 


1F4 


1F8 


SMF 70AMN 


SMF70AMM 


SMF 70ATT 
SMF70A00 


SMF70A01 


SMF70A02 


SMF70A03 


SMF 70A04 


SMF 70A05 


SMF 70A06 


SMF70A07 


SMF 70A08 


SMF 70A09 


SMF70A10 


SMF70A11 


2 


2 
4 
4 


binary 


internal 
(Set by ERBMFECP) 


internal 
(Set by ERBMFECP) 


Logical wait users minimum over interval 
Logical wait users maximum over interval 
Logical wait users total value over interval 


Count of times the number of logical wait 
users was 0 


Count of times the number of logical wait 
users was 1 or 2 


Count of times the number of logical wait 
users was 3 or 4 


Count of times the number of logical wait 
users was 5 or 6 


Count of times the number of logical wait 
users was 7 or 8 


Count of times the number of logical wait 
users was 9 or 10 


Count of times the number of logical wait 
users was 11 - 15 


Count of times the number of logical wait 
users was 16 - 20 


Count of times the number of logical wait 
users was 21 - 25 


Count of times the number of logical wait 
users was 26 - 30 


Count of times the number of logical wait 
users was 31 - 35 


Count of times the number of logical wait 
users was 36 or more 
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Record Type 71 (47) — Paging Activity 





Record type 71 is written by ERBMFDPP for each measurement interval and when 
the session is terminated. It contains information about the demands made on the 
system paging facilities and the utilization of real storage and external page storage 
during the reporting interval. Its length is 540 bytes. 


For a description of the mapping macro, see record type 70. 


The format is: 


[offsets | Name et eae 
0 0 SMF71LEN binary internal Record length 
2 SMF71SEG 2 binary internal Segment descriptor 
4 4 SMF71FLG 1 binary SMFWTM service System indicator 
POURING Bit Meaning When Set 
0 A subsystem ID follows the standard header; 
record is in relocatable format 
1-4 Reserved 
5 MVS/XA 
6 VS2 
7 Reserved 
SMF71RTY 1 binary internal Record type: 71 (X’47’) 
SMF71TME 4 binary SMFWTM service Time, in hundredths of a second, when record was 
routine moved to SMF buffer 
10 A SMF71DTE 4 packed SMFWTM service Date record was moved to SMF buffer, in the form 
routine OOyydddF, where F is the sign 
14 E SMF71SID 4 EBCDIC | SMCASID System identification (taken from SID parameter) 
18 12 SMF71SSI 4 EBCDIC | internal Subsystem identification (‘RMF’) 
22 16 SMF71STY 2 binary internal Record subtype=1 
24 18 SMF71TRN 2 binary internal Number of triplets in this record! 
26 1A 2 binary Reserved 
28 1C SMF71PRS 4 binary internal Offset to RMF product section 
32 20 SMF71PRL 2 binary internal Length of RMF product section 
34 22 SMF71PRN 2 binary internal Number of RMF product sections 
36 24 SMF71PDS 4 binary internal Offset to paging data section 
40 28 SMF71PDL 2 binary internal Length of paging data section 
42 2A SMF71PDN 2 binary internal Number of paging data section 
44, 2C SMF71SWS 4 binary internal Offset to swap placement data section 
48 30 SMF71SWL 2 binary internal Length of swap placement data section 
50 32 SMF71SWN 2 binary internal Number of swap placement data sections 
RMF Product Section: 
0 0 SMF71MFV 2 EBCDIC/| STSCMIV (in RMF version number. For more information on the 
packed STSCT) version number, see the RMF version number descrip- 
tion in record type 70 and the Resource Measurement 
Facility (RMF) Reference and User’s Guide. 
2 2 SMF71PRD EBCDIC | internal Product name (‘RMF’) 
10 A SMF711IST 4 packed internal Time RMF measurement interval started, in the form 
OhhmmssF, where F is the sign 
14 E SMF71DAT 4 packed internal Date RMF measurement interval started, in the form 


OOyydddF, where F is the sign 


1A triplet is a set of offset/length/number values that defines a section of the record. 
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System Management Facilities (SMF) 





TNL GN28-0944 (16 September 1985) to GC28-1153-3 


Lortsets | Name [Length | Format | Source | aseription 


RMF Product Section (Cont): 
18 12 SMF71INT 4 packed 



















internal Duration of RMF measurement interval, in the form 
mmsstttF, where F is the sign. (The end of the measure- 
ment interval is the sum of the record start time and this 


field. 





SMF71MFL binary 
24 18 SMF71SAM 4 binary 


internal Record maintenance indication 





internal (Set by 
ERBMFEPG) 


Number of RMF samples 














28 1C SMF71RV2 2 binary 
30 1E SMF71FLA 2 binary 


Reserved 








internal Flags 











Bit |Meaning When Set 
0 Used internally by RMF post processor 
1-15 Reserved 









32 20 SMF71RLS 4 EBCDIC | CVTRELNO Operating system release number and level, in the form 


nnil 


















36 24 SMF71CYC 4 packed internal Sampling cycle length, in the form OOOttttF, where F is 


the sign 





40 28 SMF71MVS 8 EBCDIC| CVTPRODN MVS software level (consists of an acronym and the 


version, release, and modification level numbers) 



















SMF71IML binary CSDIOML Indicates the type of processor on which data 


measurements were taken 





Value Meaning 

01 308x or 908x processor 
02 4381 processor 

03 3090 processor 





SMF71PRF 1 binary internal 






X'80’ indicates the system has extended storage 
Reserved 
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Paging Data Section: 


+0 


+4 


+8 


+12 


+16 


+20 


+24 


+28 


+32 


+36 
+40 
+44 


+48 
+52 
+56 
+60 
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+0 


+4 


+8 


+C 


+10 


+14 


+18 


+1C 


+20 


+24 


+28 


+2C 


+30 
+34 
+38 
+3C 


SMF71PIN 


SMF71POT 


SMF71PRC 


SMF71SSQ 


SMF71SIN 


SMF71SOT 


SMF71VIN 


SMF 71VOT 


SMF71VRC 


SMF71SNI 


SMF 71SNO 


SMF71SNR 


SMF71LNI 
SMF71LNR 
SMF71AFC 
SMF71TFC 


binary 


binary 


binary 


binary 


binary 


binary 


binary 
binary 
binary 
binary 


System Management Facilities (SMF) | 


RCETOTPI 


RCETOTPO 


RCETOTRC 


RCENSWPS 


RCESWPP\ 


RCESWPPO 


RCEVIOPI 


RCEVIOPQ 


RCEVIORU 


RCECOMPI 


RCECOMPO 


RCECOMRC 


RCELPAPI 
RCELPARC 
RCEAFC 
RCEPOOL 


Number of non-VIO, non-swap page-ins. This field includes 
page-ins required through page faults, specific page requests, 
and page fixes. It does not include page reclaims, page-ins 
for VIO data sets, and pages that are swapped in. 


Number of non-VIO, non-swap page outs. This field 
includes page-outs required through specific page requests 
as well as those pages stolen by the paging supervisor as a 
result of infrequent use. It does not include page-outs for 
V1O data sets and pages that are swapped out. 


Number of non-VIO, non-swap page reclaims. This field 
contains the number of requests for pages as a result of 
page faults, specific page requests, and page fixes that are 
satisfied without starting new page-ins. It does not include 
those pages that are recovered by explicit VIO reclaim. 


Number of address space swap sequences. (A swap sequence 
consists of an address space swap-out and swap-in.) 


Number of pages swapped in. This field includes: LSQA, 
fixed pages, and those pages that the real storage manager 
determined to be active when the address space was 
swapped in. It does not include page reclaims. 


Number of pages swapped out. This field includes: LSQA, 
private area fixed pages, and private area non-fixed changed 
pages. 


Number of VIO page-ins. This field includes page-ins 
resulting from page faults or specific page requests on a 
VIO window. It does not include VIO swap-ins or page-ins 
for the common area. 


Number of VIO page-outs. This field includes page-outs 
resulting from specific page requests on a VIO window as 
well as those pages stolen by the paging supervisor as a 
result of infrequent use. It does not include VIO swap-outs 
or page-Outs for the common area. 


Number of VIO page reclaims. This field includes page 
reclaims required through a VIO request that was satisfied 
without page-in by means of the explicit VIO reclaim 
interface. 


Number of non-V1IO page-ins performed in common area 
(LPA/CSA). 


Number of non-V!IO page-outs performed in common area 
(LPA/CSA). 


Number of non-VIO page reclaims performed in common 
area (LPA/CSA). 


Number of non-VIO, non-swap page-ins performed in LPA. 
Number of non-V1O, non-swap reclaims performed in LPA. 
Number of page frames available in real storage. 


Number of page frames defined in real storage. (This field 
does not include frames occupied by the nucleus and 
frames marked as bad or offline.) 





(Continued) 


J 
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Paging Data Section: (continued) 


+64 
+68 


+72 


+76 


+80 


+84 
+88 
+92 
+96 


+100 


+104 


+108 


+112 


+116 


+120 
+124 
+128 


2 From the IARXCRMEF service routine 


+40 
+44 


+48 


+4C 


+50 


+54 
+58 
+5C 
+60 


+64 


+68 


+6C 


+70 


+74 


+78 
+7C 
+80 


SMF71TSC 
SMF 71DSC 


SMF71VSC 


SMF71NSC 


SMF71FIN 


SMF 71MNF 
SMF71MXF 
SMF71AVF 
SMF71MNP 


SMF71MXP 


SMF71AVP 


SMF71MNS 


SMF71MXS 


SMF71AVS 


SMF 71MNT 
SMF71MXT 
SMF71AVT 


&- bh Lh fH 


5S 


binary 


binary 


binary 


binary 


binary 
binary 
binary 
binary 


binary 


binary 


binary 


binary 


binary 


binary 
binary 
binary 


ASMSLOTS 
ASMVSC 


ASMNVSC 


ASMSLOTS- 
(ASMVSC + 
ASMNVSC + 
ASMERRS) 


(CVTDOFFE- 
CVTDOFFS)+ 
(CVTRWNE- 
CVTRWNS)+ 
(CVTERWNE- 
CVTERWNS)+ 
(CVTRONE- 
CVTRONS) 


RCEAFC 
RCEAFC 
RCEAFC 
RCECOMAL- 


LPA frames 2. 
SQA frames ~ 


RCEOMAL- 
LPA frames 2 - 
SQA frames 


RCECOMAL- 
LPA frames 2 
SOA frames 


RCEPOOL- 
RCEAFC- 
RCECOMAL- 
LSQA frames 


RCEPOOL- 
RCEAFC- 
RCECOMAL- 
LSQA frames 2 


RCEPOOL- 
RCEAFC- 
RCECOMAL- 
LSQA frames 


RCEPOOL 
RCEPOOL 
RCEPOOL 


Total number of local page data set slots. 


Number of local page data set slots allocated to VIO 
private area pages. 


Number of local page data set slots allocated to non-VIO 
private area pages. 


Number of usable local page data set slots that have not 
been allocated 


Number of frames in nucleus 


Minimum number of unused page frames 
Maximum number of unused page frames 
Average number of unused page frames 


Minimum number of CSA frames 


Maximum number of CSA frames 


Average number of CSA frames 


Minimum number of pageable address space frames in the 
private address space 


Maximum number of address space frames in the private 
address space 


Average number of address space frames in the private 
address space 


Minimum total number of frames 


Maximum total number of frames 





Average total number of frames 


(Continued) 
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Paging Data Section: (continued) 
+132 | +84 SMF71MNQ 
+136 | +88 SMF71MXQ 
+140 | +8C SMF71AVQ 
+144 | +90 SMF71MNC 


















SOA frames2 
SOA frames~ 
SQA frames2 


binary Minimum number of SQA fixed frames 





















binary Maximum number of SQA fixed frames 















binary Average number of SQA fixed frames 






















- fh Hh FA 


common fixed 
frames? 


binary Minimum number of CSA + LPA fixed frames 















+148 | +94 SMF71MXC 4 





common fixed Maximum number of CSA + LPA fixed frames 


frames= 


binary 
























+152 | +98 SMF71AVC 4 common fixed 


frames® 


RCETOTFX- 
SQA frames? - 
LSOA frames?- 
common fixed 
frames? 


RCETOTFX- 
SOA frames2- 
LSQA frames2- 
common fixed 
frames? 


RCETOTFX- 
SOA frames2- 
LSQA frames?- 
common fixed 
frames? 


binary Average number of CSA + LPA fixed frames 














+156 SMF71MNR binary Minimum number of non-LSQA fixed frames in the 


private address space 




















SMF71MXR 





binary Maximum number of non-LSQA fixed frames in the 


private address space 























SMF71AVR binary Average number of non-LSQA fixed frames in the 


private address space 







SMF71MNX RCETOTFX Minimum total number of fixed frames 






SMF71MXX 
SMF71AVX 





RCETOTFX 
RCETOTFX 


Maximum total number of fixed frames 








Average total number of fixed frames 


2From the IARXCRME service routine (Continued) 
3From the I|ARXCNTEFE service routine 
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Paging Data Section: (continued) 


+180 


+184 


+188 


+192 


+196 


+200 


+204 


+208 


+212 


+216 


+220 


+224 


+228 


+232 


+236 


+238 


+240 
+244 
+248 
+252 
+256 
+260 
+264 
+268 
+272 
+276 
+280 
+284 
+288 
+292 
+296 


+B4 


+B8 


+BC 


+CO 


+C4 


+C8 


+CC 


+DO 


+D4 


+D8 


+DC 


+E0 


+E4 


+E8 


+EC 


+EE 


+FO | 


+F4 

+F8 

+FC 

+100 
+104 
+108 
+10C 
+110 
+114 
+118 
+11C 
+120 
+124 
+128 


SMF71MNU 


SMF71MXU 


SMF71AVU 


SMF71MNV 


SMF71MXV 


SMF71AVV 


SMF71MNM 


SMF71MXM 


SMF71AVM 


SMF71MNB 


SMF71MXB 


SMF71AVB 


SMF71MNA 


SMF71MXA 


SMF711S1 


SMF711S2 


SMF71TIS 
SMF71LWS 
SMF71DWS 
SMF71ULS 
SMF71NRS 
SMF71ASS 
SMF71RSS 
SMF71EXS 
SMF71EES 
SMF71TOS 
SMF71TXS 
SMF71LGS 
SMF71LFS 
SMF71LSS 
SMF71LSE 


4 


N 


ASMSLOTS- 
(ASMVSC + 
ASMNVSC + 
ASMERRS) 


ASMSLOTS- 
(ASMVSC + 
ASMNVSC + 
ASMERRS) 


ASMSLOTS- 
(ASMVSC + 
ASMNVSC + 
ASMERRS) 
ASMVSC 
ASMVSC 
ASMVSC 
ASMNVSC 
ASMNVSC 
ASMNVSC 


ASMERRS 


ASMERRS 


ASMERRS 


ASMSLOTS 


ASMSLOTS 


internal 


internal 





Minimum number of usable local page data set slots that 
have not been allocated 


Maximum number of usable local page data set slots that 
have not been allocated 


Average number of usable local page data set slots that 
have not been allocated 


Minimum number of local page data set siots allocated to 
VIO private area pages 


Maximum number of local page data set slots allocated 
to VIO private area pages 


Average number of local page data set slots allocated to 
VIO private area pages 


Minimum number of local page data set slots allocated to 
non-V1IO private area pages 


Maximum number of local page data set page slots allocated 
to non-VIO private area pages 


Average number of local page data set slots allocated to 
non-VIO private area pages 


Minimum number of unusable local page data set 
slots 


Maximum number of unusable local page data set 
slots 


Average number of unusable local page data set 
slots 


Minimum total number of local page data set 
slots 


Maximum total number of local page data set 
slots 


Number of invalid samples skipped due to 
IARXCNTF 

Number of invalid samples resulting from 
negative calculations 


Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
Reserved 
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Paging Data Section: (continued) 


+300 |+12C | SMF71NLP 4 binary LPA frames2 Minimum number of LPA frames 

+304 [+130 | SMF71XLP 4 binary LPA frames2 Maximum number of LPA frames 

+308 [+134 | SMF71ALP 4 binary LPA frames2 Average number of LPA frames 

+312 [+138 | SMF71NLF 4 binary LPA fixed frames2 | Minimum number of LPA fixed frames 

+316 1+13C | SMF71XLF 4 binary LPA fixed frames? | Maximum number of LPA fixed frames 

+320 +140 | SMF71ALF 4 binary LPA fixed frames2 Average number of LPA fixed frames 

+324 1+144 | SMF71NLS 4 binary LSQA frames2 Minimum number of LSQA fixed frames 

+328 |+148 | SMF71XLS 4 binary LSQA frames2 Maximum number of LSQA fixed frames 

+332 |+14C | SMF71ALS 4 binary LSQA frames2 Average number of LSQA fixed frames 

+336 |+150 | SMF71MNL 4 binary RCEBELFX Minimum number of fixed frames below 16 megabytes 

+340 |+154 | SMF71MXL 4 binary RCEBELFX Maximum number of fixed frames below 16 megabytes 

+344 1+158 | SMF71AVL 4 binary RCEBELFX Average number of fixed frames below 16 megabytes 

+348 |+15C | SMF71PMV 4 binary RCEPAGMV Total number of pages moved 

+352 1+160 | SMF710OPT 8 EBCIDIC | RMPTOPTN SRM opt member name 

+360 | +168 | SMF71PES 4 binary RCEESWRT Total number of pages moved to extended storage 

+364 1+16C | SMF71PEA 4 binary RCENWSF Total number of pages migrated from extended storage 

+RCEWSDNE to auxiliary storage 

+368 |+170 | SMF71AMN 4 binary RCEAEC Minimum number of available extended storage frames 

+372 1+174 | SMF71AMX 4 binary RCEAEC Maximum number of available extended storage frames 

+376 1+178 | SMF71ASA 4 binary RCEAEC Average number of available extended storage frames 

+380 |+17C | SMF71LIC 4 binary MCVSTCRI Minimum high UIC | 

+384 1+180 | SMF71HIC 4 binary MCVSTCRI Maximum high UIC 

+388 |+184 | SMF71ACA 4 binary MCVSTCRI Average high UIC (scale factor=—1) see note 1 

+392 |1+188 | SMF71LMA 4 binary MCVMGAGE Minimum migration age; the time an unreferenced page 
remains in extended storage before migrating to auxiliary 
storage 

+396 |+18C | SMF71HMA 4 binary MCVMGAGE Maximum migration age; the time an unreferenced page 
remains in extended storage before migrating to auxiliary 
storage 

+400 | +190 | SMF71AMA 4 binary MCVMGAGE Average migration age; the time an unreferenced page 
remains in extended storage before migrating to auxiliary 
storage (scale factor=—1) see note 1 

+404 /+194 | SMF71CF 4 binary SCCBNXSB* Number of installed extended storage frames 

SCCBMESI 
+408 | +198 | SMF710OLE 4 binary RCEESPL Number of online extended storage frames 





Swap Placement Section: (One per swap reason, located by SMF71SWS). See Note 2. 


0 
4 
8 


12 


2From the I|ARXCRMF service routine 
Note 1: Scale factor —1 means the field has been multiplied by 10 to give a result in tenths and must be multiplied by 10 
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0 
4 
8 


10 
14 


SMF 71 TOT 
SMF71AXD 
SMF71LES 


SMF71LAX 


SMF71ESD 
SMF71MIG 


correct value. 


4 
4 
4 


binary 
binary 


binary 


binary 


binary 


binary 


System Management Facilities (SMF) 


RMCATOSC 
SWCT 
SWCT 


SWCT 


SWCT 
SWCT 


Total number of swap candidates 
Number of physical swaps directed to auxiliary storage 


Number of logical swaps physically swapped to extended 
storage 


Number of logical swaps physically swapped to auxiliary 
storage 


Number of physical swaps directly to extended storage 


Total number of physical swaps that migrated from 
extended storage to auxiliary storage 


; to get the 





Note 2: There are eleven swap placement sections, one per swap reason. |f there were no swaps for a particular reason, its data fields 
contain zeroes. The sections are ordered as follows: 


Section number Reason 


oa 


Terminal output wait 
Terminal input wait 

Long wait 

Auxiliary storage shortage 
Real pageable storage shortage 
Detected wait 

Request swap 

Enqueue exchange 

Exchange on recommendation value 
Unilateral 

Transition to non-swappable 


=o oon oo fh W NY 


—__ oh 
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L 


Record Type 72 (48) — Workload Activity 


SMF72LEN 
SMF72SEG 
SMF72FLG 


SMF72RTY 
SMF72TME 


SMF72DTE 


SMF72SID 
SMF72SSI 
SMF72STY 
SMF72TRN 


SMF72PRS 
SMF 72PRL 
SMF72PRN 
SMF72WLS 
SMF72WLL 
SMF72WLN 
SMF 72PGS 
SMF 72PGL 
SMF72PGN 


4 
4 
2 
2 
2 
4 
2 
2 
4 
2 
2 
4 
2 
2 


Record type 72 is written by ERBMFDWP for each performance group 
(PG) defined in the installation performance specification (IPS). Type 
72 records are generated in the order of low to high PG number. Each 
record contains data on the one-to-eight PG periods for a PG number. 
Its length is 204 bytes plus 56 bytes for each performance group period 


data section. 


This record contains the PG number, number of PG periods, IPS name, 
number of terminated transactions, elapsed time of terminated trans- 
actions, and active time, service and workload level of all transactions. 
Resource and service information is also provided on IOC, CPU, ERV, 
MSO, and SRB. 


For a description of the mapping macro, see record type 70. 


The format is: 


binary 
binary 


binary 


binary 


binary 


packed 


EBCDIC 
EBCDIC 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


binary 


internal 
internal 


SMFWTM 
service 
routine 


internal 


SMFWTM service 
routine 


SMDWTM service 
routine 


SMCASID 
internal 
internal 


internal 


internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 





Offers | _Neme __{ tengtn | Format {| __Sowren | __Deserptoy 


Record length 
Segment descriptor 
System indicator 


Bit Meaning When Set 

0 A subsystem |D follows the standard header; 
record in relocatable format 

14 Reserved 

5 MVS/XA 

6 VS2 

7 Reserved 


Record type: 72 (X'48’) 


Time, in hundredths of a second, record was moved to 
SMF buffer 


Date record was moved to SMF buffer, in the form 
OOyydddF, where F is the sign 


System identification (taken from SID parameter) 
Subsystem identification ('RMF’) 

Record subtype=1 

Number of triplets in this record | 

Reserved 

Offset to RMF product section 

Length of RMF product section 

Number of RMF product section 

Offset to workload control section 

Length of workload control section 
Number of workload control sections 
Offset to performance group period section 
Length of performance group period section 


Number of performance group period sections 


1a triplet is a set of offset/length/number values that defines a section of the record. 
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RMF Product Section: 


0 


10 


14 


18 


22 
24 
28 
30 


32 


36 


40 


48 
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0 


12 


16 
18 
1C 
1E 


20 


24 


28 


30 


31 
32 


Workload Control Section: 
SMF72FGI 


+0 


+6 
+E 
+11 
+14 
+1A 





+1E 


SMF72MFV 


SMF72PRD 
SMF721ST 


SMF 72DAT 


SMF72INT 


SMF72MFL 
SMF72SAM 
SMF72RV2 
SMF72FLA 


SMF72RLS 
SMF72CYC 
SMF72MVS 


SMF72IML 


SMF 72PRF 


SMF72RV3 
SMF72SUB 
SMF72HPG 


SMF72IPS 
SMF72IRF 
SMF72CRF 
SMF72ERF 
SMF721SD 
SMF72CSD 








2 


MO NHN & ND 


& fF OD WwW WwW OW 


EBCDIC/ 
packed 


EBCDIC 
packed 


packed 


packed 


binary 
binary 
binary 


binary 


EBCDIC 
packed 
EBCDIC 


binary 


binary 


binary 


binary 


binary 


EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 


System Management Facilities (SMF) 


Source 


internal 


internal 


internal 


internal 


internal 


internal 


internal 


internal 


CVTRELNO 


internal 


CVTPRODN 


CSDIOML 


internal 


internal 


internal 


WAMTHPG 


WAMTIPS 
RMPTOPI 
RMPTOPC 
RMPTOPE 
WAMTIPI 
WAMTIPC 





CPU service definition coefficient 


RMF version number. For more information on the RMF 
version number, see the RMF version number description 
in record type 70 and the Resource Measurement Facility 
(RMF) Reference and User’s Guide. 


Product name 


Time RMF measurement interval started, in the form 
OhhmmssF, where F is the sign 


Date RMF measurement interval started, in the form 
OOyydddF, where F is the sign 


Duration of RMF measurement interval, in the form 
mmsstttF, where F is the sign. (The end of the measure- 
ment interval is the sum of the recorded start time and 
this field.) 


Record maintenance indication 
Number of RMF samples 
Reserved 

Flags 


Bit (Meaning When Set 


0 Used internally by RMF post processor 
1-15 Reserved 


Operating system release number and level, in the form 
nnil 

Sampling cycle length, in the form OOOttttF, where F is 
the sign 

MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 


Indicates the type of processor complex on which data 
measurements were taken 


Value Meaning 

01 308x or 908x processor 
02 4381 processor 

03 3090 processor 


x‘80’ indicates the system has extended storage 


Reserved 


Flags 


Bit (Meaning When Set 
0-5 Reserved 


6 Report class 
7 Change to performance sensitive variable was made 
Reserved 


Subcategory code, performance group (PG) number 


Highest PG number defined in installation performance 
specification (IPS) or installation control specification 
(ICS) 


Name of IPS 

IOC resource factor coefficient 
CPU resource factor coefficient 
ERV resource manager coefficient 


IOC service definition coefficient 


J 
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Workload Control! Section: (continued) 


+34 
+38 
+42 
+50 
+58 


+62 


+72 


+82 


+92 


+22 
+26 
+2A 
+32 
+3A 


+3E 


+48 


+52 


+5C 


SMF72MSD 
SMF72SSD 
SMF720PT 
SMF72ICS 
SMF72SYS 


SMF72CLS 


SMF72USR 


SMF72NAM 


SMF72ADJ 


4 EBCDIC 
a EBCDIC 
8 EBCDIC 
8 EBCDIC 
4 EBCDIC 
10 EBCDIC 
10 EBCDIC 
10 EBCDIC 
4 binary 


Performance Group Period Data Section: 


+0 
+4 


+8 
+12 


+16 


+20 
+24 
+28 
+32 


+36 
+40 
+42 


+43 
+44 
+48 


+52 


+0 
+4 


+8 


+10 


+14 
+18 
+1C 
+20 


+24 
+28 
+2A 
+28 
+2C 
+30 


+34 


SMF72TTX 
SMF72ACT 


SMF72SER 
SMF72TTM 


SMF72LEV 


SMF72MTS 
SMF72ITS 

SMF72CTS 
SMF72TAT 


SMF 72SPP 
SMF 72CON 
SMF72PON 
SMF72TSG 
SMF72STS 
SMF72ETI 


SMF72ET2 


4 binary 
a binary 
4 binary 
4 binary 
4 binary 
4 binary 
a | binary 
4 binary 
4 binary 
4 binary 
2 binary 
1 binary 
1 binary 
4 binary 
& binary 
4 binary 


WAMTIPM 
WAMTIPB 
RMPTOPTN 
AMPTICSN 


Symbolic name 
table 


Symbolic name 
table 
Symbolic name 
table 


Symbolic name 
table 


RMCTADJ 


WAMPTRN 


WAMPTAT 
(Set by 
IRARMWAR) 


WAMPSRV 


WAMPTET (Set by 
iIRARMWAR) 


WAMPNWL., 


WAMPMSO 
WAMPIOC 

WAMPCPU 
WAMPTRR 


WAMPSWC 
WAMPOMN 
WAMPOBJN 
WAMPTSGN 
WAMPSRB 
WAMPETS 


WAMPETS 


Main storage service definition coefficient 
SRB service definition coefficient 

Name of IEAOPTxx member 

Name of [EAICSxx member 


Name of subsystem associated with this PGN 


Name of class associated with this PGN 


User identifier associated with this PGN 


Name of transaction associated with this PGN 


CPU time per service unit (in microseconds), multiplied 
by 16. RMF uses this field to derive the number of service 
units per CPU second. 





Number of transactions terminated 


Active time of ail transactions, in 1024-microsecond units. 
This field includes the total time that each transaction was 
in real storage pius any swapped-out time that the 
transactions were not in a long ‘‘wait"’ state. It does not 
include time between job steps for batch transactions. 


Service used in ail transactions, in service units. 


Elapsed time accumulated by all transactions that 
terminated in this PG period, in 1024-microsecond units. 


Workload level of ail transactions, in units of 1/256 of a 
level 

Main storage total service units 

I/O total service units 2 
CPU total service units 


Transaction residency time, in 1024-microsecond units. 
This field does not include time between job steps for 
batch transactions. 


Number of swep sequences in period 
Domain number 

Performance objective number 

Time slice group number 

SRB total service units 


The first four bytes of the sum of the squares of the 
elapsed times accumulated by all ended transactions; 
this field is used to calculate standard deviation 


The secdnd four bytes of the sum of the squares. 


2 
See /nitialization and Tuning, for an explanation of how |/O service units are measured. 
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Record Type 73 (49) — Channel Path Activity 


SMF 73LEN 
SMF 73SEG 
SMF 73FLG 


SMF73RTY 
SMF 73TME 


SMF73DTE 


SMF 73SID 
SMF73SSI 

SMF 73ST Y 
SMF73TRN 


SMF73PRS 
SMF 73PRL 
SMF 73PRN 
SMF73HIS 
SMF 73HIL 
SMF 73HIN 
SMF 73HPS 
SMF73HPL 
SMF73HPN 


RMF Product Section: 


SMF73MFV 


4 
4 
2 
2 
2 
4 
2 
2 
4 
2 
2 
4 
2 
2 





Record type 73 is written by ERBMFDHP when channel path activity measurement 
is requested. Entries are created for all channel paths in the system that are valid/ 

installed since RMF was started. However, report data is not formatted for channel 
paths that were offline at the end of the reporting interval or for channel paths that 
were reconfigured during the interval. Its length depends on the number of installed 


channels. 


The record contains identification information and channel path use data. 


For a description of the mapping macro, see record type 70. 


The format is: 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


EBCDIC/ 


packed 


System Management Facilities (SMF) 


internal 


internal 


SMFWTM service 


routine 


internal 


SMFEWTM service 


routine 


SMWTM service 


routine 
SMCASID 
internal 
internal 


internal 


internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 


STSCMF1V 
(in STSCT) 


a 


Record length 

Segment descriptor 
System indicator 

Bit Meaning When Set 


A subsystem ID follows the standard header; 
record is in relocatable format 

Reserved 

MVS/XA 

VS2 

Reserved 


Record type: 73 (X‘49’) 


Time, in hundredths of a second, record was moved 
to SMF buffer 


Date record was moved to SMF buffer, in the form 
OOyydddF, where F is the sign 


System identification (taken from SID parameter) 
Subsystem identification (‘RMF’) 
Record subtype=1 


Number of triplets in this record! 


Reserved 

Offset to RMF product section 

Length of RMF product section 

Number of RMF product section 

Offset to channel path control section 
Length of channel path control section 
Number of channel path control sections 
Offset to channel path data section 
Length of channel path data section 


Number of channel path data sections 


RMF version number. For more information on the RMF 
version number, see the RMF version number description 
in record type 70 and the Resource Measurement Facility 
(RMF) Reference and User’s Guide. 





1A triplet is a set of offset/length/number values that defines a section of the record. 


J 
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RMF Product Section (continued): 
2 2 SMF73PRD 8 EBCDIC internal Product name 


10 A SMF 73IST 4 packed internal Time RMF measurement interval started, in the form 
OhhmmssF, where F is the sign 


14 E SMF73DAT 4 packed internal Date RMF measurement interval started, in the form 
OOyydddF, where F is the sign 


18 12 SMF 73INT 4 packed interval Duration of RMF measurement interval, in the form 
mmsstttF, where F is the sign. (The end of the measure- 
ment interval is the sum of the recorded start time and 


this field.) 
22 16 SMF73MFL 2 binary internal Record maintenance indication 
24 18 SMF 73SAM 4 binary internal Number of RMF samples 
28 1C SMF73RV2 2 binary Reserved 
30 1E SMF73FLA 2 binary internal Flags 
Bit |Meaning When Set 
0 Used internally by RMF processor 
1-15 Reserved 
32 20 SMF73RLS 4 EBCDIC | CVTRELNO Operating system release number and level, in the form 
nnil 
36 24 SMF73CYC a packed internal Sampling cycle length, in the form OOOttttF, where F is 


the sign (taken from CYCLE option). The range of values 
is 0.050 to 9.999 seconds. 


40 28 SMF73MVS 8 EBCDIC | CVTPRODN MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 


48 30 SMF73IML 1 binary CSDIOML Indicates the type of processor complex on which data 
_— measurements were taken 


Value Meaning 

01 308x or 908x processor 
02 4381 processor 

03 3090 processor 


49 31 SMF73PRF 1 binary internal x‘80' indicates system has extended storage 
+50 | +51 2 Reserved 


Channel Path Control Section (one per record): 


SMF73SMP CPMTSAMP Number of times SRM issued STCPS to sample channel 
path busy; SRM OPT parmlib options. RMFTTOM sets 
the rate of STCPS. 





Channel Path Data Section (one per channel path): 
+0 +0 SMF73PI1D 1 binary 
+1 +1 SMF73FG2 1 binary 


Channel path identification 


Channel flags 


Meaning When Set 


Reserved 

Block multiplexor 

Byte multiplexor 

Reserved 

Partial statistics 

Data recorded is invalid because channel path was 
reconfigured during interval 

Channel path is currently online 


+2 +2 SMF73RV5 2 binary 
+4 +4 SMF 73BS Y 4 binary CMPTBUSY 


Reserved 


Number of samples in which the channel path was busy 





c 
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Record Type 74 (4A) — Device Activity 





Record type 74 is written by ERBMFDDP for all devices specified in the DEVICE 
option. It contains entries for all devices that have been online at least once since 
RMF was started. The entry for any device that was offline at the end of the report- 
ing interval, or for any device that was taken offline during the interval, does not 
contain data. The length of record type 74 is 112 bytes plus 84 bytes for each 

device data section. Because the maximum length of an SMF record is 32,756 

bytes, a maximum of 388 device data sections can fit in one record. 


This record identifies the sampling cycle length, number of samples, and the num- 
ber of devices. Each device entry contains the volume serial number (tape and 
direct access devices only), numbers of requests serviced on the device, the total 
active, pending, and connect time to service those requests, requests enqueued for 
the device, and the device number, class, and type, as well as other data collected 
about the device. 


For a description of the mapping macro, see record type 70. 


The format is: 


8 ee a a ee 


SMF74LEN binary internal Record length 
SMF74SEG binary internal Segment descriptor 


SMF74FLG binary SMFWTM service System indicator 


OUTING Bit | Meaning When Set 


0 A subsystem ID follows the standard 
header; record is in relocatable format 
Reserved 
MVS/XA 
VS2 
Reserved 


SMF74RTY binary internal Record type: 74 (X’4A') 


SMF74TME binary SMFWTM service Time, in hundredths of a second, record was moved 
routine to SMF buffer 


SMF74DTE packed SMFWTM service Date record was moved to SMF buffer, in the form 
routine OOyydddF, where F is the sign 


EBCDIC} SMCASID System identification (taken from StD parameter) 
EBCDIC] internal Subsystem identification (‘RMF’) 





SMF74SID 
SMF74SSI 

SMF 74STY 
SMF74TRN 


binary internal Record subtype=1 


binary internal Number of triplets in this record | 


binary Reserved 
SMF74PRS 

SMF74PRL 

SMF74PRN 
SMF74DCS 

SMF 74DCL 
SMF74DCN 
SMF74DDS 
SMF74DDL 
SMF74DDN 


binary internal Offset to RMF product section 

binary internal Length of RMF product section 
binary internal Number of RMF product sections 
binary internal Offset to device control data section 
binary internal Length of device control data section 
binary internal Number of device control data section 
binary internal Offset to device data section 


binary internal Length of device data section 


Oo NO 2B HY NH PB NY NY FS HB NY NY HP FA 


binary internal Number of device data section 





1A triplet is a set of offset/length/number values that defines a section of the record. 
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c 


ortets [Name _[usnatn | Format | Sowes [——~SC pti 


RMF Product Section: 


0 


14 


18 


22 
24 


28 
30 


32 


36 


40 


48 


49 
50 


0 


12 


16 
18 


1C 
1E 


20 


24 


28 


30 


31 
32 


SMF74MFV 


SMF74PRD 
SMF74IST 


SMF74DAT 


SMF 74INT 


SMF74MFL 
SMF74SAM 


SMF74RV2 
SMF74FLA 


SMF74RLS 


SMF74CYC 


SMF74MVS 


SMF74IML 


SMF74PRF 


2 EBCDIC/ 


packed 
8 EBCDIC 
packed 
4 packed 
4 packed 
binary 
4 binary 
binary 
binary 
4 EBCDIC 
4 packed 
8 EBCDIC 
1 binary 
1 binary 


2 


Device Control Data Section (one per record): 


+0 


+2 


+0 


+2 


+4 


+6 


SMF 74NXT 


SMF74TOT 


SMF74GEN 


SMF74SUB 


2 binary 
2 binary 
2 binary 
2 binary 


STSCMFIV 
(in STSCT) 


internal 
interval 


internal 


internal 


internal 


internal (Set by 
(ERBMFEDV) 


internal 


CVTRELNO 


internal 


CVTPRODN 


CSDIOML 


internal 


internal 


internal 


internal 


UCBTBYT3 





RMF version number. For more information on the RMF 
version number, see the RMF version number description 
in record type 70 and the Resource Measurement Facility 
(RMF) Reference and User’s Guide. 


Product name 


Time RMF measurement interval started, in the form 
OhhmmssF, where F is the sign 


Date RMF measurement interval started, in the form 
OOyydddF, where F is the sign 


Duration of RMF measurement interval, in the form 
mmsstttF, where F is the sign. (The end of the mea- 
surement interval is the sum of the recorded start time 
and this field.) 


Record maintenance indication 


Number of RMF samples 


Reserved 
Flags 


Bit Meaning When Set 
0 Used internally by RMF post processor 
1-15 Reserved 


Operating system release number and level, in the form 
nnil 


Sampling cycle length, in the form OOOttttF, where F 
is the sign (taken from CYCLE option). The range of 
values is 0.050 to 9.999 seconds. 


MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 


Indicates the type of processor complex on which data 
measurements were taken 


Value Meaning 

01 308x or 908x processor 
02 4381 processor 

03 3090 processor 


x'80’ indicates system has extended storage 


Reserved 


Number of device data sections in following records for 
this class 


Total number of device data sections in all records for 
this class 


Total number of devices specified for all classes at system 
generation 


Device class code: 


Bit Configuration Meaning 


‘0080’X 
‘0040’X 
‘0020’X 
0010'X 
‘0008'X 
‘0004'X 


Magnetic tape device 
Communication equipment 
Direct access devices 
Graphics devices 

Unit record devices 
Character reader devices 
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Corie [Name [toostn] Foret | Souee [SSC 


Device Data Section (one per device): 


+0 
+2 
+4 
+5 


+12 
+16 
+20 
+24 


+28 
+32 
+36 


+40 
+44 
+48 


+52 


+56 
+60 


+68 


+72 


+74 


+76 
+80 


6-178 


+0 
+2 
+4 
+5 


+C 

+10 
+14 
+18 


+1C 
+2D 
+24 


+28 
+2C 
+30 


+34 


+38 
+3C 


+40 


+44 


+48 


+4A 


+4C 
+50 


SMF74NUM 
SMF74LCU 


SMF74RV3 
SMF 74CNF 


SMF74QUL 
SMF74LCD 


SMF74CMB 


SMF74PAR 
SMF74MXB 


SMF74VAC 


SMF74STA 
SMF74SER 


SMF74TYP 
SMF 74NUX 
SMF74SSC 

SMF 74MEC 


SMF74CNN 
SMF74PEN 
SMF74ATV 


SMF74DIS 
SMF74QUE 
SMF74UTL 


SMF74RSV 


SMF74DSO 
SMF74ALC 


SMF74MTP 


SMF 74NRD 


SMF 74COF 


SMF74ICT 


SMF74DVB 
SMF74CUB 


2 


2 
1 
1 


> fh fh A 


A ~ 


binary 
binary 
binary 
binary 


EBCDIC 


binary 
binary 
binary 


binary 


binary 
binary 


binary 


binary 
binary 


binary 


binary 


binary 
binary 


binary 


binary 


binary 


binary 


binary 


binary 


System Management Facilities (SMF) 


UCBNAME 
lOCDS 


tLOSUCNT routine 
IOCDS absent or 
unreadable 
internal 


internal 
UCBMTPXP and 
UCBBASE 
UCBONLI 


UCBONLI 
UCBVOLI 


UCBTYP 
UCBNEXP 
CMBSSCHC 
CMBSAMP 


CMBCONNT 
CMBPENDT 


CMBCONNT 
CMBPENDT 
CMBDISCT 


CMBDISCT 
IOSVCNT routine 


UCBRESVH 
UCBSTRT 


UCBRESVH 
UCBRESVP 


UCBDMC 
UCBALOC 


UCBMOUNT 
UCBALOC 
UCBNRY 


UCBNRY 


UCBDCTOF 


IOCSTSQE 
(1OS Service) 


SCHMDTDB 
SCHMDTCB 





J 





Device number, in the range X‘0000’ to X‘OF FF’ 

Logical control unit number, in the range X‘00' to X’FF’ 
Reserved. Used internally. 

Device indicator 

Bit Meaning When Set 


0 IOS queue length is invalid 
1 No logical control unit information 


CMB data is invalid 
Reserved 
Only partial statistics are available 
Device is a multiple exposure device; this is base 
exposure 
Data recorded is invalid because device was con- 
figured during interval 
7 Device is currently online 


Volume serial of the volume mounted on this device 
(tape or direct access device only) 


Unit type 
Number of exposures for a multiple exposure device 
Start subshannel count 


Measurement event count (number of SSCH instructions 
for which connect, pending, and active times were stored) 


Device connect time (in 128 microsecond units) 





Device pending time (in 128 microsecond units) 


Device active time (in 128 microsecond units) 


Device disconnect time (in 128 microsecond units) 
Number of requests queued in IOS for this device 


Number of samples when the device was reserved but an 
SSCH instruction had not been issued to the device 


Number of samples taken when the device was reserved 


Total number of data sets open on the device 


Number of samples taken that indicated that the device 
was allocated 


Number of samples taken that indicated a mount pending 
condition 


Number of samples taken that indicated that the device 
was not ready 


Number of requests that had hardware timer overflow 
for connect time measurement 


Number of invalid samples 


Device busy delay time, from SCHIB. 


Control unit busy delay time 





Record Type 75 (4B) — Page/Swap Data Set Activity 
Record type 75 is written by ERBMFDSP at the end of each RMF measurement 
interval. One record is written for each page data set or swap data set monitored 
during the interval. It provides information on the use of auxiliary storage page 
slots, and the use of the page/swap data set by ASM. Its length is 200 bytes. 


For a description of the mapping macro, see record type 70. 


The format is: 


a 


SMF75LEN 
SMF75SEG 
SMF75FLG 


SMF 75RTY 
SMF75TME 


SMF75DTE 


SMF75SID 
SMF 75SSI 

SMF75STY 
SMF75TRN 


SMF75PRS 
SMF 75PRL 
SMF75PRN 
SMF75PSS 
SMF75PSL 
SMF75PSN 


SMF75MFV 


SMF75PRD 
SMF 75IST 


SMF 75DAT 


SMF 75INT 


4 
4 
2 
2 
2 
4 
2 
2 
4 
2 
2 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


EBCDIC/ 
packed 


EBCDIC 


packed 


packed 


packed 


internal 


internal 


SMWETM service 


routine 


internal 


SMFWTM service 


routine 


SMFWTM service 


routine 
SMCASID 
internal 
internal 


internal 


internal 
internal 
internal 
internal 
internal 


internal 


STSCMF1V 
(in STSCT) 


internal 


internal 


internal 


internal 





Record length 
Segment descriptor 
System indicator 


Bit (Meaning When Set 
A subsystem ID follows the standard 
header; record is in relocatable format 
Reserved 
MVS/XA 
VS2 
Reserved 


Record type: 75 (X'4B’) 


Time, in hundredths of a second, record was moved to 
SMF buffer 


Date record was moved to SMF buffer, in the form 
OOyydddF, where F is the sign 


System identification (taken from SID parameter) 
Subsystem identification (‘RMF’) 

Record subtype=1 

Number of triplets in this record | 

Reserved 

Offset to RMF product section 

Length of RMF product section 

Number of RMF product section 

Offset to page/swap data set data section 

Length of page/swap data set data section 


Number of page/swap data set data sections 


RMF version number. For more information on the RMF 
version number, see the RMF version number description 
in record type 70 and the Resource Measurement 
Facility (RMF) Reference and User’s Guide. 


Product name 


Time RMF measurement interval started, in the form 
OhhmmssF, where F is the sign 


Date RMF measurement interval started, in the form 
OOyydddF, where F is the sign 


Duration of RMF measurement interval, in the form 
mmsstttF, where F is the sign. (The end of the measure- 
ment interval is the sum of the recorded start time and 
this field.) 


1a triplet is a set of offset/length/number values that defines a section of the record. 
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SMF75MFL 
SMF75SAM 


SMF75RV2 
SMF 75FLA 


SMF75RLS 


SMF75CYC 


SMF75MVS 


SMF75IML 


SMF75PRF 


binary 
binary 


binary 
binary 


EBCDIC 


packed 


EBCDIC 


binary 
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internal (Set by 


ERBMFESP) 


internal 


CVTRELNO 


internal 


CVTPRODN 


CSDIOML 


internal 


i 


Record maintenance indication 


Number of RMF samples 


Reserved 


Bit | Meaning When Set 
0 Used internally by RMF post processor 
1-15 Reserved 


Operating system release number and level, in the form 
nnill 


Sampling cycle length, in the form OOOttttF, where F is 
the sign (taken from CYCLE option). The range of 


values is 0.050 to 9.999 seconds. 


MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 


Indicates the type of processor complex on which data 
measurements were taken 


Value Meaning 

01 308x or 908x processor 
02 4381 processor 

03 3090 processor 


X'80’ indicates system has extended storage 


Reserved 





c 


+0 


+44 


+45 


+46 
+47 
+51 


+53 
+59 
+64 


+68 
+72 
+76 


+80 
+84 


+88 


+92 
+96 
+100 


+0 


+2C 


+2D 


+2E 
+2F 
+33 


+35 
+3B 
+40 


+44 


+48 


+4C 


+50 


+54 


+5A 


+5C 
+62 
+64 


SMF 75DSN 


SMF 75PST 


SMF 75FL2 


SMF 75RV5 
SMF75TYP 
SMF75CHA 


SMF75VOL 
SMF75RV3 
SMF75SLA 


SMF 75MXU 


SMF 75MNU 


SMF 75AVU 


SMF75BDS 


SMF75USE 


SMF 75REQ 


SMF75S!10 
SMF75PGX 
SMF75RV8 


44 EBCDIC 


1 binary 


1 binary 
binary 


2 binary 


EBCDIC 


binary 


binary 


4 binary 


4 binary 


4 
4 
4 
4 
binary 
binary 
4 binary 


PARTDSNL or 
SARDSNL 


PARETYPE 


internal 


UCBTYP 
UCBNAME 


UCBVOLI 


PARESZSL or 
SRETOTSL 


(PARESZSL - 
PARESLTA) or 
(SRETOTSL - 
SREAVLSL) 


(PARESZSL - 
PARESLTA) or 
(SRETOTSL - 
SREAVLSL) 


(PARESZSL - 
PARESLTA) or 
(SRETOTSL - 
SREAVLSL) 


PARERRCT or 
SRERRCT 


lIORFUSE 


IORFUSE 


IORSION 
IORTREQ 





[offens [Nemo [tergth [Format Sowes[——~—sDweription id 


Page/Swap Data Set Data Section: 


Page/swap data set name 


Page space type 


Meaning When Set 

PLPA 

COMMON 

DUPLEX 

LOCAL 

SWAP 

Data set unusable 

Data set came online during interval 
Reserved 


NOohWN- OD 
> 


Tl 

o 
re] 

” 


Meaning When Set 

Data set accepts VIO pages 

Data set on multiple exposure device 

Data set on device with alternate control unit 
3-7. Reserved 


Reserved 


n= OD 
sy 


Unit type 


Device number in the form hhhF, hex digits followed 
by F 


Volume serial number 
Reserved 


Total number of slots or swap sets contained within the 
page or swap data set 


Maximum number of slots used or maximum number of 
swap sets used 


Minimum number of slots used or minimum number of 
swap sets used 


Average number of slots used or average number of swap 
sets used 


Number of unusable slots or unusable swap sets 


Number of samples indicating data set was being used by 
ASM 


Number of requests for the data set observed during RMF 
sampling. For single exposure devices, this is the same as 
SMF75USE. For multiple exposure devices, this value is 

the sum of all outstanding requests on all exposures. 


Number of |1/O requests for the data set 
Number of pages transferred to or from page data set 


Reserved 
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Record Type 76 (4C) — Trace Activity 


SMF 76LEN 
SMF76SEG 
SMF 76FLG 


SMF76RTY 
SMF 76TME 


SMF76DTE 


SMF76SID 
SMF76SSI 

SMF 76ST Y 
SMF 76RTN 


SMF76PRS 
SMF 76PRL 
SMF 76PRN 
SMF76TCS 
SMF76TCL 
SMF76TCN 
SMF 76TDS 
SMF76TDL 
SMF76TDN 
SMF76VFS 
SMF76VFL 
SMF76VFN 


SMF 76MFV 


SMF76PRD 
SMF 76IST 


4 
4 
2 
2 
2 
4 
2 
2 
4 
2 
2 
4 
2 
2 
4 
2 
4 


Record type 76 is written by ERBMFDTP at the end of each measurement interval. 
One record is written for each field name sampled during the interval. Record type 
76 contains information on the number of samples, the number of sets, (lines of 
data), the minimum value of the field, the maximum value of the field, the sum of 
the squared values of the field, and the final value sampled from the field. The 
trace values collected for each set are grouped at the end of the record. The length 
of record type 76 is 166 bytes plus 2 or more bytes for the length of the variable 
trace data section. 


—Otests | __Name___ Lenath | Fermet_1__Souree _{__Deseription 


binary 
binary 
binary 


binary 


binary 


packed 


EBCDIC 
EBCDIC 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


EBCDIC/ 
packed 


EBCDIC 
packed 


internal 


internal 


SMFWTM service 


routine 


internal 


SMFEWTM service 


routine 


SMFWTM service 


routine 
SMCASID 
internal 
internal 


internal 


internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 


STSCMFIV 
(in STSCT) 


internal 


internal 


Record length 
Segment descriptor 
System indicator 


Bit | Meaning When Set 
A subsystem ID follows the standard header; 
record is in relocatable format 
Reserved 
MVS/XA 
VS2 
Reserved 


Record type: 76 (X‘4C’) 


Time, in hundredths of a second, record was moved to 
SMF buffer 


Date record was moved to SMF buffer, in the form 
OOy ydddF, where F is the sign 


System identification (taken from SID parameter) 
Subsystem identification (‘RMF’) 
Record subtype=1 

Number of triplets in this record | 
Reserved 

Offset to RMF product section 
Length of RMF product section 
Number of RMF product section 
Offset to trace control section 
Length of trace control section 
Number of trace control sections 
Offset to trace data entry section 
Length of trace data entry section 
Number of trace data entry sections 
Offset to variable format set 

Length of variable format set 


Number of variable format sets 


RMF version number. For more information on the RMF 
version number, see the RMF version number description 
in record type 70 and the Resource Measurement Facility 
(RMF) Reference and User’s Guide. 


Product name 


Time RMF measurement interval started, in the form 





OhhmmssF, where F is the sign 


1A triplet is a set of offset/length/number values that defines a section of the record. 
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System Management Facilities (SMF) 


9 








L 


[ores [Name [Lenath [ Format | Sowes [——~—~S~—~eeription 


RMF Product Section (continued): 


14 


18 


22 
24 
28 
30 


32 


36 


40 


48 


49 
50 


E 


12 


16 
18 
1C 
1E 


20 


24 


28 


30 


31 
32 


SMF 76DAT 


SMF 76INT 


SMF76MFL 
SMF76SAM 
SMF 76RV2 
SMF76FLA 


SMF76RLS 


SMF76CYC 


SMF76MVS 


SMF76IML 


SMF 76PRF 


Trace Control Section: 


SMF76NUM 
SMF 76RV4 


Trace Data Section: 


SMF 76NAM 


SMF 760PT 





4 


NM NO & ND 


packed 


packed 


EBCDIC 


packed 


EBCDIC 


binary 


binary 


binary 


EBCDIC 


binary 


internal 


internal 


internal 


ERBMFETR 


internal 


CVTRELNO 


internal 


CVTPRODN 


CSDIOML 


MFTRTRAC 
ERBMFETR 





Date RMF measurement interval started, in the form 
OOyydddF, where F is the sign 


Duration of RMF measurement interval, in the form 
mmsstttF, where F is the sign. (The end of the measure- 
ment interval is the sum of the recorded start time and 
this field.) 


Record maintenance indication 
Number of RMF samples 
Reserved 

Flags 


Bit Meaning When Set 
0 Used internally by RMF post processor 
1-15 Reserved 


Operating system release number and evel, in the form 
nnil 


Sampling cycle length, in the form OOOttttF, where F is 
the sign (taken from CYCLE option). The range of 
values is 0.050 to 9.999 seconds. 


MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 


Indicates the type of processor complex on which data 
measurements were taken 


Value Meaning 

01 308x or 908x processor 
02 4381 processor 

03 3090 processor 


X'80’ indicates system has extended storage 


Reserved 


Number of sample sets (lines of data) in the trace 


Reserved 


Field name 
Trace options 


Meaning When Set 

Minimum value of the field is contained in the 
SMF record 

Maximum value of the field is contained in the 
SMF record 

The sum of the values required to calculate the 
average of the field is contained in the SMF record 
The sum of the squared values required to calculate 
the standard deviation of the field is contained in 
the SMF record 

End value of the field is contained in the SMF 
record 

All options selected 

Domain tracing terminated 

This entry is a domain field 


Chapter 6. SMF Records 6-183 


[oftets [Name | Length | Format | Sours [—~—~S~C« arpa 


Trace Data Section: (continued) 
SMF76SLN binary Length of a set 
SMF 76DLN binary ERBMFETR Length of a field sampled 
SMF 76SSS binary ERBMFETR Standard samples per set used 
SMF 76SSL binary Samples per set 
SMF 76MIN binary ERBMFETR Minimum value during interval 
SMF 76MAX binary ERBMFETR Maximum value during interval 
SMF 76AVG binary ERBMFETR Accumulated value used to compute the average 
SMF76STD binary ERBMFETR Sum of squares (used to compute standard deviation) 
SMF 76ENV binary ERBMFETR End value of field 
Variable Trace Data Section: 





SMF76C or ERBMFETR Trace values collected for each set, stored in an array of 

SMF76D either fullwords or halfwords, depending on the length of 
the field being sampled (SMF 76C if fullwords; SMF 76D if 
halfwords). There will be one group of values for each 
sample set (line of data) in the trace 


Length of data in bytes and relative 


Size of position in array 


Array 

Element} Min. | Sum of | Max. | Sum of 

in Bytes | Value] Values | Value] Sq. Vals| Value 
panera 2 | 2] 6 [2] 8 
worst # fete [el 2 
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Record Type 77 (4D) — Enqueue Activity 


Record type 77 is written by ERBMFDEQ at each measurement interval and when 
the session is terminated. It contains data that identifies the resources for which 
ENQ/DEQ contention occurred during the measurement interval and data that 
describes any contention that occurred. Its length is 106 bytes, plus 156 bytes for 
each resource for which data was gathered. 


For a description of the mapping macro, see record type 70. 


The format is: 


[Offsets | _Neme | Length [Format | Source ——~—~=~S~S~i sariptiom 


Record Type 77 (4D) — Enqueue Activity 


0 
2 
4 


10 


14 
18 
22 
24 
26 
28 
32 
34 
36 
40 
42 
44 
48 
50 


0 
2 


4 


12 
16 
18 
1A 
1C 
20 
22 
24 
28 
2A 
2C 
30 
32 


SMF77LEN 
SMF77SEG 
SMF77FLG 


SMF77RTY 
SMF77TME 


SMF77DTE 


SMF77SID 
SMF77SSI 
SMF77STY 
SMF77TRN 


SMF77PRS 
SMF77PRL 
SMF77PRN 
SMF77EQS 
SMF77EQL 
SMF77EQN 
SMF77EDS 
SMF77EDL 
SMF77EDN 


RMF Product Section: 


SMF77MFV 


SMF77PRD 
SMD77IST 


SMF77DAT 





2 
2 
1 


mo OM F—& YM NY F& NY VY FP NY NAN NY AL A 


binary 
binary 


binary 


binary 


binary 


packed 


EBCDIC 
EBCDIC 


binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


binary 


EBCDIC/ 


packed 


EBCDIC 


packed 


packed 


internal 
internal 


SMFWTM service 
routine 


internal 


SMFWTM saervice 
routine 


SMFWTM service 
routine 


SMCASID 
internal 
internal 


internal 


internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 


STSCMF1V 
(in STSCT) 


internal 


internal 


internal 





Record length 
Segment descriptor 
System indicator 


Bit | Meaning When Set 
0 A subsystem ID follows the standard header; 
record is in relocatable format 
Reserved 
MVS/XA 
VS2 
Reserved 


Record type: 77 (X‘'4D') 


Time, in hundredths of a second record was moved to 
SMF buffer 


Date record was moved to SMF buffer, in the form 
OOyydddF, where F is the sign 


System identification (taken from SID parameter) 
Subsystem identification (‘RMF’) 
Record subtype=1 

Number of triplets in this record 1 
Reserved 

Offset to RMF product section 
Length of RMF product section 
Number of RMF product section 
Offset to enqueue control section 
Length of enqueue control section 
Number of enqueue control sections 
Offset to enqueue data section 
Length of enqueue data section 


Number of enqueue data sections 


RMF version number. For more information on the RMF 
version number, see the RMF version number description 
in record type 70 and the Resource Measurement Facility 
(RMF) Reference and User’s Guide. 


Product name 


Time RMF measurement interval started, in the form 
OhhmmssF, where F is the sign 


Date RMF measurement interval started, in the form 
OOyydddF, where F is the sign 


1A triplet is a set of offset/length/number values that defines a section of the record. 
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[Ofhets [Nemo Length [Format | Source [| ——~—~—~S~CSi arin SC ) 


RMF Product Section (continued): 


+9 | +9 SMF 760P1 1 binary ERBMFETR Trace options 
Bit Meaning When Set 
0 LPB trace requested 
1 LPB trace request ended 
18 12 SMF77INT 4 internal Duration of RMF measurement interval, in the form 


mmsstttF, where F is the sign. (The end of the measure- 
ment interval is the sum of the recorded start time and 


this field.) 
22 16 SMF77MFL 2 internal Record maintenance indication 
24 18 SMF77SAM 4 internal Number of RMF samples 
28 1C SMF77RV2 2 Reserved 
30 1E SMF77FLA 2 internal Flags 


Bit | Meaning When Set 
0 Used internally by RMF post processor 
1-15 Reserved 


32 | 20 SMF77RLS 
36 | 24 SMF77CYC 


EBCDIC 
packed 


CVTRELNO Operating system release number and level, in form nnil 


internal Sampling cycle length, in the form OOOttttF, where F is 
the sign (taken from CYCLE option). The range of 
values is 0.050 to 9.999 seconds. 


CVTPRODN MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 


40 | 28 SMF77MVS 8 EBCDIC 


48 30 SMF77IML 1 binary CSDIOML Indicates the type of processor complex on which data 
measurements were taken 
Value Meaning 
01 308x or 908x processor ut 
02 4381 processor 
03 3090 processor 
49 |} 31 SMF77PRF 1 X‘80’ indicates system has extended storage 


Reserved 


binary internal Enqueue status indicator 


Meaning 
On — enqueue summary table full 
On — specified resource had no contention 


On — enqueue had bad CPU clock 

On — enqueue event processing abend 
On — detail data requested 

Off — summary data requested 
Reserved 


SMF77RF2 Reserved 
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Enqueue Data Section: 


+0 
+8 
+52 


+56 


g see 


+70 
+72 
+74 
+76 
+78 
+80 
+82 
+84 


+86 
+87 


+88 
+90 
+92 
+100 
+108 
+116 
+124 
+132 
+140 


+148 


+0 

+8 

+34 
+38 
+3C 
+40 
+42 
+44 
+46 
+48 
+4A 
+4C 
+4E 
+50 
+52 
+54 


+56 
+57 


+58 
+5A 
+5C 
+64 
+6C 
+74 
+7C 
+84 
+8C 


+94 


SMF77QNM 
SMF77RNM 
SMF77WTM 
SMF77WTX 
SMF77WTT 
SMF77RV3 
SMF77QL1 
SMF77QL2 
SMF77QL3 
SMF77QL4 
SMF77QLT 
SMF77E XM 
SMF77E XX 
SMF77SHM 
SMF77SHX 
SMF 77EVT 


SMF77RLN 
SMF77DFG 


SMF77DOW 
SMF77DWR 
SMF77D01 
SMF77D02 
SMF 77DW1 
SMF 77DW2 
SMF77SY 1 
SMF77SY2 
SMF77SY3 


SMF77SY4 


EBCDIC 
EBCDIC 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


binary 
binary 


binary 


binary 


EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 


EBCDIC 





RIBQNAME 
RIBRNAME 
internal 


internal 


internal 
internal 
RIBNTWE + 
RIBNTWS 
RIBNTWE + 
RIBNTWS 
RIBNTWE + 
RIBNTWS 
RIBNTWE + 
RIBNTWS 
RIBNTWE + 
RIBNTWS 
RIBNTWE 
RIBNTWE 
RIBNTWS 
RIBNTWS 
internal 


RIBRNMLN 
internal 


internal 

internal 

RIBEJBNM 
RIBEJBNM 
RIBEJBNM 
RIBEJBNM 
RIBESYSN 
RIBESYSN 
RIBESYSN 


RIBESYSN 


Major name of resource 

Minor name of resource 

Minimum resource contention time, in 1024-microsecond 
units 

Maximum resource contention time, in 1024-microsecond 
units 

Total resource contention time, in 1024-microsecond units 
Reserved 

Counter for queue length of 1 


Counter for queue length of 2 
Counter for queue length of 3 
Counter for queue length of 4 or more 


Total number of waiting requests during the measurement 
interval 

Minimum number of exclusive requests waiting 

Maximum number of exclusive requests waiting 

Minimum number of share requests waiting 

Maximum number of share requests waiting 


‘Total number of contention events that occurred during 


the measurement interval 
Minor name length 
Current resource detail indicator 


Bit Meaning When Set 


0 On — resource still in contention 

1 On -— scope of systems 
Off — scope of system 

2 On — owner has exclusive control of the resource 
Off ©— owner shares the resource 

3 On ~-— first job is waiting for exclusive use 
Off — first job is waiting for shared use 

4 On -— second job is waiting for exclusive use 
Off — second job is waiting for shared use 

5 On — resource is global 
Off — resource is local 


6-7 Reserved 

Number of owners using the resource at maximum 
contention 

Number of jobs waiting for the resource at maximum 
contention 

Job name 1 of resource owner at maximum contention 
Job name 2 of resource owner at maximum contention 
Job name 1 waiting for the resource at maximum 
contention 

Job name 2 waiting for the resource at maximum 
contention 

System identifier of job name 1 (resource owner-at 
maximum contention) 

System identifier of job name 2 (resource owner at 
maximum contention) 

System identifier of job name 1 (waiting for the resource 
at maximum contention) 

System identifier of job name 2 (waiting for the resource 
at maximum contention) 
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Record Type 78 (4E) Monitor I Activity 


SMF78LEN 
SMF78SEG 
SMF78FLG 


SMF78RTY 
SMF78TME 


SMF78DTE 


SMF78SID 
SMF78SSI 
SMF78STY 
SMF78TRN 


SMF78PRS 
SMF78PRL 
SMF78PRN 
SMF78DCS 
SMF78DCL 
SMF78DCN 
SMF78ASS 
SMF78ASL 
SMF78ASN 


4 
4 
2 
2 
2 
4 
2 
2 
4 
2 
2 
4 
2 
2 


Record type 78 has three sub-types and is written by ERBMFDOQ (sub-type 1), 
ERBMFDVP (sub-type 2) or ERBMFDGQ (sub-type 3) during a Monitor I session. 
Sub-type 1 and sub-type 3 report I/O queuing activity and contain an entry for 

each logical control unit that had any activity during the interval. Sub-type 2 reports 
virtual storage activity and contains acommon storage data section and possibly 

one or more private area data sections. 


The record has a standard SMF header and product section that are common to both 
sub-types. The length of record type 78 depends on the sub-type. For sub-type 1 the 
length is 108 bytes plus 56-92 bytes for each logical control unit. For sub-type 2, 
the minimum length is 1836 bytes if no private area data is included. Otherwise, 

the length is 1836 bytes plus at least 392 bytes for each private area that is 
monitored. For sub-type 3, written only when RMF is measuring data on a 3090 
processor, the length is 108 bytes plus 60-96 bytes for each logical control unit. 


For a description of the mapping macro, see record type 70. 


The format is: 


8 ee ee ann 


binary internal Record length 


internal 


SMFWTM service System indicator 
routine Bit 


binary Segment descriptor 


binary 


Meaning When Set 

0 A subsystem ID follows standard header; record 
is in relocatable format 

Reserved 

MVS/XA 

VS2 

Reserved 


Record type 78 (X’4E’) 


Time in hundreths of a second when record was moved 
to SMF buffer 


internal 


SMFWTM service 
routine 


SMDWTM service 
routine 


SMCASID 


binary 


binary 


Date record was moved to SMF buffer, in the form 
OOyydddF where F is the sign 


System identification (taken from SID parameter) 


packed 


EBCDIC 
EBCDIC 
binary 


internal Subsystem identification (‘RMF’) 


internal Subtype 


binary internal Number of triplets in record 1 


binary Reserved 


binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
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internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 





internal 


Offset to RMF product section 
Length of RMF product section 
Number of RMF product sections 
Offset to data control section 
Length of data control section 
Number of data control sections 
Offset to data section 

Length of data section 


Number of data sections 


1A triplet is a set of offset/length/number values that defines a section of the record. 





c 


OC 





The following three fields apply only to sub-type-2: 

















+52 | +34 SMF78SPS 4 binary internal Offset to private area subpool section 





















+56 | +38 





SMF78SPL 2 binary internal Length of private area subpool section 

















+58 | +3A SMF78SPN 2 binary internal Number of private area subpool sections 





The following three fields apply only to sub-type 3, written when RMF is running on a 3090 processor. 










SMF78QDS 
SMF 78Q0DL 
SMF780DN 





internal Offset to {OQ global section. 











internal Length of 10Q global section 











internal Number of 10Q global section 







RMF Product Section: 






















0 0 SMF78MFV EBCDIC/| STSCMF1V RMF version number. For more information on the 
packed (in STSCT) version number, see the RMF version number descrip- 

tion in record type 70 and the Resource Measurement 
Facility (RMF) Reference and User’s Guide. 

2 2 SMF 78PRD EBCDIC | internal Product name 

10 A SMF 78IST packed internal Time RMF Monitor | measurement interval started, in 
the form OhhmmssF, where F is the sign 

14 E SMF 78DAT packed internal Date RMF Monitor | measurement interval started, in 


the form OOyydddF, where F is the sign 






18 12 SMF 78INT Duration of RMF Monitor | measurement interval, in 
the form mmsstttF where F is the sign. (The end of the 
measurement interval is the sum of the recorded start 


time and this field.) 


packed internal 





Record Maintenance Indication 


Number of RMF samples. This field is used to 
calculate the averages for the common storage data 
section fields. 


Reserved 


22 16 SMF78MFL 
24 18 SMF78SAM 


binary internal 






binary internal 







28 1C SMF78RV2 
30 1E SMF 78FLA 






binary 





binary internal Flags 


Bit Meaning When Set 
0 Used internally by RMF post processor 
1-15 Reserved 





CVTRELNO 





32 20 SMF78RLS EBCDIC Operating system release number and level, in the form 


nnoll 







36 24 SMF78CYC Sampling cycle length, in the form OOOttttF, where F is 
the sign (taken from CYCLE option). The range of 


values is 0.050 to 9.999 seconds. 


packed internal 





40 28 SMF78MVS EBCDIC | CVTPRODN MVS software level (consists of an acronym and the 


version, release, and modification level numbers) 






48 30 SMF78IML binary CSDIOML Indicates the type of processor complex on which data 


measurements were taken 






Value Meaning 

01 308x or 908x processor 
02 4381 processor 

03 3090 processor 


49 31 SMF 78PRF 
50 32 


internal 






X‘80' indicates system has extended storage 


Reserved 


Chapter 6. SMF Records 6-189 






Offsets 


[Name [ Length | Format [| Sowee [—~SC merit 


| Sub-type 1 I/O Queuing Control Section for the 308x, 908x, and 4381 processors: (one per LCU, described by triplet SMF78DCS) 












+0 +0 R7811D1 1 binary internal Logical control unit identifier 

+2 +2 R781NTR 2 binary internal Number of triplets following 

+4 +4 R781CPDS 4 binary internal Offset to |/O queuing configuration data section 

+8 +8 R781CPDL 2 binary internal Length of I/O queuing configuration data section 

+10] +A R781CPDN 2 binary internal Number of I/O queuing configuration data sections for 


this logical control unit 
Sub-type 1 I/O Queuing Configuration Data Section for the 308x, 908x and 4381 processors: (one per channel path, 
described by triplet R781CPDS) 


+0 +0 R781CPID 1OCDS 
+1 +1 R781CPST 1 binary Channel path status 

















binary Channel path identifier 


























Bit (Meaning When Set 
ICHCONFG 0 ON = channel path installed 
ICHONLIN 1 ON = channel path online 
ERBMFEAR 2 ON = channel path varied 
(module) 3 ON =channel path offline to all devices 
of the LCU 
4 ON = channel path connection to devices of 
the LCU altered by VARY PATH during interval 


5-7 Reserved 















R781CUN 
+4 +4 R781CU1 
+6 +6 R781CU2 
+8 +8 R781CU3 
+10] +A R781CU4 


binary 1OCDS Number of control units attached 
binary 1IOCDS First control unit attached 








binary IOCDS Second control unit attached 









binary lIOCDS Third control unit attached 








MPO NO NY NHN WN 


binary 1OCDS Fourth control unit attached 
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c 


+0 


+1 


+2 


+8 
+12 
+16 


+20 


+24 


+28 
+30 


+0 


+1 


+2 


+8 
+C 
+10 


+14 


+18 


+1C 
+1E 


R781DST 


R781ICT 
R781ABY 


R781TIS 
R781SIS 
R781CUB 


R781DVB 


R781QUE 


R7811D2 


1 
1 


2 
2 


binary 


binary 


binary 


binary 
binary 
binary 


binary 


binary 


binary 


CMCTPAA 


1OCDS + UCB’S 


internal 


SCHIB 
SCHIB 
SCHIB 


SCHIB 


SCHIB 


lOCDS 


Torts [Name [usnatn] Format | Sowee [SSC aaiption 


Sub-type 1 |/O Queuing Data Section for the 308x, 908x, and 4381 processors: (one per LCU, described by triplet SMF 78ASS) | 


Reserved 
Data Status 


Bit Meaning When Set 
0 No STCPS data available 


1 No UCB found - normal if |OCDS defines more 
devices than SYSGEN 


2 No hardware measurements available 
3-7 Reserved 


Count of invalid samples 


Number of samples when all channel paths in the logical 
control unit were busy 


Total number of initial selection attempts 
Total number of successful selection attempts 


Total number of unsuccessful selection attempts because 
control unit was busy 


Total number unsuccessful selection attempts because 
device was busy 


In a 308x/908x processor complex, total number of re- 
quests queued for the logical control unit (accumulated 
at initial selection time) 


Logical control unit identifier 
Reserved 


Sub-type 2 (Virtual Storage) Common Storage Data Section: (described by triplet SMF78DCS) 


w\ +0 


+4 
+8 

+12 
+16 
+20 
+24 
+28 
+32 
+36 


+48 
+52 


+56 
+60 


+68 


( +72 
+76 


+0 
+4 
+8 
+C 
+10 
+14 
+18 
+1C 
+20 
+24 
+28 
+2C 


+30 
+34 


+38 
+3C 


+40 
+44 


+48 
+4C 


R782PA 
R782PS 
R782EPA 
R782EPS 
R782CA 
R782CS 
R782ECA 
R782ECS 
R782BA 
R782BS 
R782MLA 
R782MLS 


R782EMLA 
R782EMLS 


R782FLA 
R782FLS 


R782EFLA 


R782EFLS 


R782PLA 
R782PLS 


> fr hf Sf bh SF FH FF SF SF SH Lf Ff 


s -S 


binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


binary 


binary 
binary 


binary 
binary 


binary 
binary 


binary 


binary 


4096 


GDAPVTSZ-4096 


GDAEPVT 
GDAEPVTS 
GDACSA 
GDACSASZ 
GDAECSA 
GDAECSAS 


CVTMLPAS 


CVTMLPAE+1 
—CVTMLPAS 


CVTEMLPS 


CVTEMLPE+1 
—-CVTEMLPS 


CVTFLPAS 


CVTFLPAE+1 
—CVTFLPAS 


CVTEFLPS 


CVTEFLPE+1 
—CVTEFLPS 


CVTPLPAS 


CVTPLPAE+1 
—CVTPLPAS 


Private area address below 16 megabytes 
Private area size below 16 megabytes 
Private area address above 16 megabytes 
Private area size above 16 megabytes 
CSA address below 16 megabytes 

CSA size below 16 megabytes 

CSA address above 16 megabytes 

CSA size above 16 megabytes 

Reserved 

Reserved 

MLPA address below 16 megabytes 
MLPA size below 16 megabytes 


MLPA address above 16 megabytes 
MLPA size above 16 megabytes 


FLPA address below 16 megabytes 
FLPA size below 16 megabytes 


FLPA address above 16 megabytes 
FLPA size above 16 megabytes 


PLPA address below 16 megabytes 
PLPA size below 16 megabytes 
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Ceres [noe [ewe [rome [eee [ee 


Sub-type 2 (Virtual Storage) Common Storage Data Section: (described by triplet SMF 78DCS) (continued) 


+80 
+84 


+88 
+92 
+96 
+100 
+104 
+108 


+112 


+116 


+120 


+124 


+128 


+132 


+136 


+140 


+144 


+184 


6-192 


+50 
+54 


+58 
+5C 
+60 
+64 
+68 
+6C 


+70 


+74 


+78 


+7C 


+80 


+84 


+88 


+8C 


+90 


+B8 


R782ELPA 
R782ELPS 


R782SA 
R782SS 
R782ESA 
R782ESS 
R782NA 
R782NS 


R782ENA 


R782ENS 


R782NL 


R782ENL 


R782LPAI 


R782ELP\ 


R782MR 


R782EMR 


R782SQAU 


R782CSAU 


4 


bh bh fb Bh Ff F 


binary 
binary 


binary 
binary 
binary 
binary 
binary 
binary 


binary 


binary 


binary 


binary 


binary 


binary 


binary 


binary 


See 
Note 1 


See 
Note 1 
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CVTEPLPS 


CVTEPLPE+1 
—CVTEPLPS 


GDASQA 
GDASOQASZ 
GDAESOA 
GDAESQAS 
CVTRWNS 


(CVTRWNE+1 
—CVTRWNS)+ 
(16 meg+1 
—CVTRONS) 


16 meg 
(16777216) 


(CVTERWNE+1 
—CVTERWNS)+ 
(CVTRONE+1 
—16 meg) 


if LPDE present, 
sum of 
LPDEXTLN for 
each CDE chained 
from CVTQLPAQ 


lf LPDE present, 
sum of 
LPDEXTLN for 
each CDE chained 
from CVTQLPAQ 


R782PLS— 
size of LPDEs— 
sum of 
LPDEXTLN 


R782ELPS— 
sum of 
LPDEXTLN 


GDAPVTSZ— 
4096—TCTHWM 
(for RMF address 
space at START 
time) 


GDAEPVTS— 
TCTEHWM (for 
RMF address 
space at START 
time) 


VSMLIST 
SP=SQA, 
SPACE=FREE 


VSMLIST 
SP=CSA, 
SPACE=ALLOC 


PLPA address above 16 megabytes 
PLPA size above 16 megabytes 


SQA address below 16 megabytes 
SQA size below 16 megabytes 

SQA address above 16 megabytes 
SOA size above 16 megabytes 
Nucleus address below 16 megabytes 


Nucleus size below 16 megabytes 


Nucleus address above 16 megabytes 


Nucleus size above 16 megabytes 


PLPA space redundant with MLPA/FLPA below 16 
megabytes 


PLPA space redundant with MLPA/FLPA above 
16 megabytes 


Intermodule space in PLPA below 16 megabytes 


Intermodule space in PLPA above 16 megabytes 


Maximum possible user region below 16 megabytes 


Maximum possible user region above 16 megabytes 


SQA usage both above and below 16 megabytes 


CSA usage both above and below 16 megabytes 


J 





L 


Tome [wm owe [ome [oe [ee 


Sub-type 2 (Virtual Storage) Common Storage Data Section: (described by triplet SMF 78DCS) (continued) 


+224 


+584 


+624 


+664 


+704 


+744 


+784 


+824 


+864 


+E0 


+248 


+270 


+298 


+2CO 


+2E8 


+310 


+338 


+360 


+1064/+428 


2The key data appears in the following order: 0,1,2,3,4, 5,6, 7, 8-F. 


R782CSAK 


R782CSAF 


R782CSLF 


R782CSAL 


R782SQAF 


R782SQLF 


R782SQAL 


R782SQEX 


R782227K 


R782228K 


360 See 
(40 Note 1 
bytes 
for 
each 
of 9 
keys) 
40 See 
Note 1 
40 See 
Note 1 
40 See 
Note 1 
40 See 
Note 1 
40 See 
Note 1 
40 See 
Note 1 
40 See 
Note 1 
200 See 
(20 Note 1 
bytes 
for 
each of 
10 keys) 
200 See 
(20 Note 1 
bytes 
for 
each of 
10 keys) 


VSMLIST 
SP=CSA, 
SPACE=ALLOC 


VSMLIST 
SP=CSA, 


SPACE=UNALLOC 


VSMLIST 
SP=CSA, 


SPACE=UNALLOC 


VSMLIST 
SP=CSA, 
SPACE=ALLOC 
and GDACSA 
+GDACSASZ and 
GDAECSA 
+GDAECSAS 


VSMLIST 
SP=SOA, 
SPACE=FREE 


VSMLIST 
SP=SQA, 
SPACE=FREE 


VSMLIST 
SP=SQA, 
SPACE=FREE 
and GDASQASZ 
and GDAESQAS 


VSMLIST 
SP=SQA, 
SPACE=FREE 


VSMLIST 
SP=CSA, 
SPACE=ALLOC 


VSMLIST 
SP=CSA, 
SPACE=ALLOC 


CSA used both above and below 16 megabytes 
by subpool key? 


Free CSA both above and below 16 megabytes 


Largest free block of CSA both above and below 16 
megabytes 


CSA allocated area size both above and below 16 
megabytes 


Free SQA both above and below 16 megabytes 


Largest free block of SQA both above and below 16 
megabytes 


SQA allocated area size both above and below 16 
megabytes 


SQA expansion into CSA both above and below 16 
megabytes 


CSA subpool 227 (below 16 megabytes) by key® 


CSA subpool 228 (below 16 megabytes) by key? 


SThe key data appears in the following order: 0,1, 2, 3,4,5,6, 7, 8-F, ALL. 
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Sub-type 2 (Virtual Storage) Common Storage Data Section: (described by triplet SMF78 DCS) (continued) 


+1264/+4FO | R782231K 200 See VSMLIST CSA subpool 231 (below 16 megabytes) by key? 
(20 Note 1 SP=CSA, 
bytes SPACE=ALLOC 
for 
each of 
10 keys) 
+1464/+568 | R782241K 200 See VSMLIST CSA subpool 241 (below 16 megabytes) by key? 
(20 Note 1 SP=CSA, 
bytes SPACE=ALLOC 
for 
each of 
10 keys) 
+1664 |+680 | R782226 20 See VSMLIST SQA subpool 226 (below 16 megabytes) 
Note 1 SP=SQA, 
SPACE=FREE 
+1684/+694 | R782239 20 See VSMLIST SQA subpool 239 (below 16 megabytes) 
Note 1 SP=SQA, 
SPACE=FREE 
+1704/+6A8 | R782245 20 See VSMLIST SQA subpool! 245 (below 16 megabytes) 
Note 1 SP=SQA, 
SPACE=FREE 


Sub-type 2 (Virtual Storage) Private Area Data Section: (described by triplet SMF78ASS) 





+0 +0 R782JOBN 8 EBCDIC | ASCBJBNS Name of job being monitored 
or ASCBJBNI 
+8 +8 R782RDTM 4 binary JMRENTRY Reader start time 
+12 | +C R782RDDT 4 packed JMREDATE Reader start date 
+16 | +10 R782SUBI 2 binary internal Index of first subpool entry in the private area 


subpool section for this job. This field provides the 
first array element for this job‘s private area subpool 
sections. 

+18 | +12 R782SUBN 2 binary internal index of last subpool entry for this job. This field 
provides the last array element for this job’s private 
area subpools. 


+20 | +14 R782STEP 8 EBCDIC | TIOCSTEP Name of step active when monitoring began 
+28 | +1C R782PGMN 8 EBCDIC | JSCBPGMN Program name of job being monitored 
+36 | +24 R782FLGS 2 binary internal Flags 


Bit Meaning When Set 





0 Job active at start of interval 
1 Job terminated during interval 
2 GETMAIN limit changed during interval 
3 Data invalid because RMF terminated 
abnormally while sampling 
4-15 Reserved 
+38 | +26 R782RSV 2 binary Reserved 
+40 | +28 R782SAMP 4 binary internal Number of samples. This field is used to calculate the 
averages in the private area data and private area 
subpool sections. 
+44 | +2C R782REGR 4 binary LDAREGRQ Region requested by JCL (in bytes) 
+48 | +30 R782RGAB 4 binary LDAVVRG Region below 16 megabytes assigned by exits (in bytes) 
+52 | +34 R782RGAA 4 binary LDAEVVRG Region above 16 megabytes assigned by exits (in bytes) 
+56 | +38 R782GMLB 4 binary LDASTRTA+ GETMAIN limit below 16 megabytes (in bytes) 
LDALIMIT 
+60 | +3C R782GMLA 4 binary GDAEPVT+ GETMAIN limit above 16 megabytes (in bytes) 
LDAELIM 


3The key data appears in the following order: 0,1, 2,3, 4, 5,6, 7, 8-F, ALL. 
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c 


Sub-type 2 (Virtual Storage) Private Area Data Section: (described by triplet SMF78ASS) (continued) 


+64 
+68 
+72 


+40 
+44 
+48 


+112] +70 


+152] +98 


+192 


+232 


+272 


+312 


+352 


+CO 


+E8 


+110 


+138 


+160 


R782URAB 
R782URAA 


R782LSFP 


R782LSFB 


R782LSAL 


R782LSPA 


R782USFP 


R782USFB 


R782USAL 


R782USPA 


4 
4 
40 


40 


40 


40 


40 


40 


40 


40 


binary 
binary 


See 
Note 1 


See 
Note 1 


See 
Note 1 


Note 1 


See 
Note 1 


See 
Note 1 


See 
Note 1 


See 
Note 1 


LDASTRTA 
GDAEPVT 


VSMLIST 
SP=PVT, 
SPACE=UNALLOC 


VSMLIST 
SP=PVT, 
SPACE=UNALLOC 


For below: 
GDAPVT+ 
GDAPVTSZ— 
(LDACRGTP+ 
size of free 

block directly 
above LDACRGTP 
from VSMLIST 
SP=PVT, SPACE= 
UNALLOC) 

For above: 
GDAEPVT 
(LDAERGTP 
block directly 
above LDAERGTP 
from VSMLIST 
SP=PVT, SPACE= 
UNALLOC) 


For below: 
LDAHIAL 
For above: 
LDAEHIAL 


VSMLIST 
SP=PVT, 
SPACE=UNALLOC 


VSMLIST 
SP=PVT, 
SPACE=UNALLOC 


LDACRGTP— 
LDASTRTA 
LDAERGTP— 
GDAEPVT 


LDALOAL 
LDAELOAL 


User region address below 16 megabytes 
User region address above 16 megabytes 


LSQA/SWA/229/230 free pages both above and below 
16 megabytes 


LSQA/SWA/229/230 largest free block both above 
and below 16 megabytes 


LSOA/SWA/229/230 allocated area size both above 
and below 16 megabytes 


LSQA/SWA/229/230 allocated pages both above 
and below 16 megabytes 


User region free pages both above and below 16 
megabytes 


User region largest free block both above and below 
16 megabytes 


User region allocated area size below 16 megabytes 


User region allocated area size above 16 megabytes 


User region pages allocated below 16 megabytes 
User region pages allocated above 16 megabytes 


Sub-type 2 (Virtual Storage) Private Area Subpool Section: (described by triplet SMF78SPS) 


+0 


+2 
+4 


+0 


+2 
+4 


R782SPN 


R782SPD 


2 


20 


binary 


See 


Note 1 


VSMLIST 
SP=PVT, 
SP=LSOA, 
SPACE=ALLOC 


VSMLIST 
SP=PVT, 
SP=LSOA, 
SPACE=ALLOC 


Subpool number“ 


Reserved 


Subpool data 


4Each private area data section occurs one after the other. All private area subpool sections follow all 
private area data sections. To relate a subpool to a job, see the R782SUBI and R782SUBN fields in 


the private area data section. 
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Note 1: 
The format of these bytes follows. For fields containing data from below 16 megabytes, use only the first 20 bytes. For fields 
containing data from both below and above 16 megabytes, use all 40 bytes. 


orm [none [ime] rome [ae [Oe 


Data collected below 16 megabytes: 





VSDBMIN binary Minimum value for below 16 megabytes 
VSDBNTME binary Time stamp for minimum* 
VSDBMAX binary Maximum value for below 16 megabytes 
VSDBXTME binary Time stamp for maximum* 


VSDBTOTL single precision Total for all samples below 16 megabytes (used to 
floating point calculate average). See SMF78SAM to calculate 
averages for common storage data section fields, and 


R782SAMP to calculate averages for private area data 
and private subpool section fields. 


Data collected above 16 megabytes: 


VSDAMIN binary Minimum value for above 16 megabytes 
VSDANTME binary Time stamp for minimum* 
VSDAMAX binary Maximum value for above 16 megabytes 
VSDAXTME binary Time stamp for maximum* 


VSDATOTL single precision Total for all samples above 16 megabytes (used to 
floating point calculate average). 





*The format of a time stamp is the high order word of the TOD clock adjusted to local time by adding CVTTZ. 
The time stamp is in units of 1.048576 seconds. 


[Offre | Name [Length] Format | Source |Description 


Sub-type 3 IOP Initiative Queue Control Section for the 3090 processor: (described by triplet SMF78QDS). 
+0 +0 R783GFLG 1 binary internal 10Q global flags 


Bit Meaning 

0 ON = invalid data because channel measurement 
facility failed 

1 ON = DIAGNOSE interface failed 

2-7 Reserved 

Reserved 


R783GNTR binary internal Number of triplets following 
R783GIDS binary internal Offset to |OP initiative queue data section 
R783GIDL binary internal Length of IOP initiative queue data section 


R783GIDN binary internal Number of IOP initiative queue data sections 
R783GSAM binary CMPTSAMP CMPT sample count 
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L 


[—offw] ___Neme [Length] Format] Souree ]——S—S—S~C~meiption 


Sub-type 3 IOP Initiative Queue Data Section for the 3090 processor: (one per initiative queue described by triplet R783GIDS) 


+0 
+2 


+3 


+8 


+0 
+2 


+3 


+8 


R7831Q1D 
R783IFLG 


R7831QSM 


R7831QCT 


2 
1 


EBCDIC 


binary 


binary 


binary 


HSA(DIAGNOSE) 
DIAGNOSE 


HSA 


HSA 


IOP initiative queue identifier 
1OP Flags 


Bit Meaning 
0 ON = IOP is installed 
1-7 Reserved 


Reserved 


Sum of the number of requests enqueued on the |OP 
initiative queue. This value represents the total length 
of the queue and is used to calculate the average queue 
length for the IOP. 


Number of IOP queue entries. This value represents the 
current queue length or the number of times an element 
was added to the queue. It is used in calculating the 
average queue length for the IOP. 


Sub-type 3 I/O Queuing Control Section for the 3090 processor: (one per LCU, described by triplet SMF78DCS) 


binary 
binary 
binary 
binary 


binary 


lOCDS 
internal 
internal 
internal 


internal 


Logical control unit identifier 

Number of triplets following 

Offset to 1/O queuing configuration data section 
Length of |/O queuing configuration data section 


Number of |/O queuing configuration data sections 


Sub-type 3 I/O Queuing Configuration Data Section for the 3090 processor: (one per channel path, described by triplet R783CPDS) 


+0 +0 R7831D1 2 
+2 +2 R783NTR 2 
+4 +4 R783CPDS 4 
+8 +8 R783CPDL 2 
+10] +A R783CPDN 2 
+0 +0 R783CPID 1 
+1 +1 R783CPST 1 
+2 +2 R783CUN 2 
+4 +4 R783CU1 2 
+6 +6 R783CU2 2 
+8 +8 R783CU3 2 
1+10] +A R783CU4 2 
+12] +C R783CUB 4 
+16 | +10 R783PT 4 
+20 | +14 R783PB 4 


binary 
binary 


binary 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
binary 
binary 
binary 


lOCDS 


ICHCONFG 
ICHONLIN 
ERBMFEAR 


lOCDS 
lOCDS 
lOCDS 
lOCDS 
lOCDS 
HSA 

HSA 
CPMTBUSY 


Channel path identifier 
Channel path status 


Bit Meaning When Set 


ON = channel path installed 

ON = channel path online 

ON = channel path varied 

ON =channel path offline to all devices of the LCU 
ON = channel path connection to all devices of the 
LCU altered by VARY PATH command during 
interval 

5 ON = measured channel path data invalid 


WN — Oo 


Number of control units attached 

First control unit attached 

Second control unit attached 

Third control unit attached 

Fourth control unit attached 

Number of times control unit was busy 
Number of times channel path was taken 


Number of samples when this channel path (CHPID) 
was busy. Used with CMPT sample count, R783GSAM. 


Sub-type 3 |/O Queuing Data Section for the 3090 processor: (one per LCU, described by triplet SMF78ASS) 


+0 
+2 


+3 


+8 


+0 
+2 


+3 


+8 


R7831D2 
R783DST 


R783QSM 
R7830QCT 


2 
1 


£ 


binary 


binary 


binary 


binary 


1\OCDS 
ENF events 


HSA 
HSA 


Logical control unit identifier 
Data Status: 


Bit Meaning 
0 ON = No hardware measurements available 


1-7 Reserved 

Reserved 

Sum of total queue length of CU-HDR 
Number of entries on CU-HDR 
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Record Type 79 (4F) — Monitor II Activity ) 


Record type 79 is written during a Monitor II background session when feedback is 
requested in the form of SMF records. It is written by ERBMFBPC at each measure- 
ment interval and when the session is terminated. It contains a section that is 
identical for all Monitor II reports and a sub-type section that is unique for each 
report. The length of the record is 112 bytes plus 92 bytes for the Monitor II sec- 
tion. The sub-types are: 


@ sub-type 1 — contains information that describes address space state data and 
address space state data by jobname; for each address space identifier included, 
the length is 52 bytes. 

e@ sub-type 2 — contains information that describes address space resource data 


and address space resource data by jobname; for each address space identifier 
included, the length is 112 bytes. 


e@ sub-type 3 — contains information that describes real storage/processor/SRM 
activity; the length is 38 bytes. 


@ sub-type 4 — contains information that describes paging activity; the length is 
68 bytes 


@ sub-type 5 — contains information that describes address space SRM data and 
address space SRM data by jobname; the length is 60 bytes for each address 
space identifier included. 


@ sub-type 6 — contains information that describes reserve data. The length is 84 
bytes 


@ sub-type 7 — contains information that describes enqueue contention data. The 
length is 89 bytes. weg” 


@ sub-type 8 — contains information that describes transaction activity; the length 
is 51 bytes for each performance group period included. 


@ sub-type 9 — contains information that describes device activity. The length 
depends on the number of devices. 


@ sub-type 10 — contains information that describes domain activity. The length 
is 52 bytes. 


@ sub-type 11 — contains information that describes paging and swap dataset 
activity. The length is variable. 


@ sub-type 12 — contains information that describes channel path activity. The 
length is variable. 


@ sub-type 13 — contains information that describes I/O queuing activity by 
logical control unit for the 308x, 908x, and 4381 processors. The length is 
variable. 


® sub-type 14 — contains information that describes I/O queuing activity by logical 
control unit for 3090 processors. The length is variable. 


For a description of the mapping macro, see record type 70. 


The format is: 
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C 


C 


[orem [Wave ses [ronne [teers [erie 


10 


14 
18 
22 
24 
26 
28 
32 
34 
36 
40 
42 
44 
48 
50 


E 

12 
16 
18 
1A 
1C 
20 
22 
24 
28 
2A 
2C 
30 
32 


SMF79LEN 
SMF 79SEG 
SMG79FLG 


SMF79RTY 
SMF 79TME 


SMF 79DTE 


SMF 79SID 
SMF79SSI 

SMF79STY 
SMF79TRN 


SMF79PRS 
SMF79PRL 
SMF79PRN 
SMF79MCS 
SMF79MCL 
SMF79MCN 
SMF 79ASS 
SMF79ASL 
SMF79ASN 


2 


NO fF& NYO NYO HB NY NYO HSPN NY NN AH A 


2 


binary 
binary 
binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


internal 


internal 


SMFWTM service 


routine 


internal 


SMFWTM service 


routine 


SMFWTM service 


routine 


SMCASID 


internal 
internal 


internal 


internal 
internal 
internal 
internal 
internal 
internal 
internal 
internal 


internal 


(The following 6 fields are not present for all subtypes. ) 


52 
56 
58 
60 
64 
66 


34 
38 
3A 
3C 
40 
42 


SMF 79DCS 
SMF 79DCL 
SMF79DCN 
SMF79QSS 
SMF79Q0SL 
SMF79QSN 


RMF Product Section: 


SMF 79MFV 


SMF79PRD 
SMF 79IST 


SMF 79DAT 





4 


NM NH PB NH N 


binary 
binary 
binary 
binary 
binary 
binary 


EBCDIC 
packed 


packed 


internal 
internal 
internal 
internal 
internal 


internal 


internal 


internal 


internal 


internal 


Record length 
Segment descriptor 
System indicator 


Bit Meaning When Set 
0 Subsystem ID following standard header, relocat- 
able record format 
Reserved 
MVS/XA 
VS2 


Record type: 79 (X‘4F’) 


Time, in hundredths, of a second when record was moved 
to SMF buffer 


Data Record was moved to SMF buffer, in the form 
OOyydddF where F is the sign 


System identification (taken from SID parameter) 
Sub-system identification (‘RMF’) 


Record subtype 


Number of triplets in this record ; 


Reserved 

Offset to RMF product section 

Length of RMF product section 
Number of RMF product sections 
Offset to Monitor I! control section 
Length of Monitor I! control section 
Number of Monitor |! control sections 
Offset to data section 

Length of data section 


Number of data sections 


Offset to data control section or configuration section 
Length of data control section or configuration section 
Number of data control section or configuration section 
Offset to |OQ global section 


Length of !0Q global section 





Number of |OQ global sections 


RMF version number. For more information on the 
version number, see the RMF version number description 
in record type 70 and the Resource Measurement Facility 
(RMF) Reference and User’s Guide. 


Product Name 


Time RMF Monitor 1 measurement interval started, in the 
form OhhmmssF, where F is the sign 


Date RMF Monitor 1 measurement interval started, in the 
form OOyydddF, where F is the sign 





1A triplet is a set of offset/length/number values that defines a section of the record. 
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[offsets [Name | Lenath | Format [| Souree[—~—~S~S~seripion 







RMF Product Section (continued): 


18 12 SMF 79INT 4 internal 





22 16 SMF 79MFL 
24 18 SMF79SAM 
28 1C SMF79RV2 
30 TE SMF79FLA 







binary internal 





binary internal 


binary 











NO NO ff ND 


binary internal 


32 20 SMF79RLS 4 EBCDIC | CVTRELNO 








36 24 SMF79CYC 4 





packed internal 


40 28 SMF79MVS 8 





EBCDIC 





CVTPRODN 









48 30 SMF79IML 1 binary CSDIOML 





49 31 SMF79PRF 1 








binary internal 


Monitor II Control Section: 


R79GTOD 







TIME macro 







R79LF2 internal 


R79RV1 
R79SES 
R79RSV 
R79USER 
R79RID 
R79CTXTL 
R79CTEXT 
R79DTXTL 
R79DTEXT 
R79IST 


binary 
EBCDIC 












MISBNAME 








binary 

EBCDIC | PCTRID 
PCTOPRD 
PCTOTEXT 
PCTDEDOL 
PCTDRO 
MFSBITOD 









binary 
EBCDIC 















binary 
EBCDIC 












packed 
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Duration of RMF Monitor 1 measurement interval, in the 
form mmsstttF where F is the sign. (The end of the mea- 
surement interval is the sum of the recorded start time 
and this field.) 


Record Maintenance Indicator 
Number of RMF samples 
Reserved 

Flags 


Bit Meaning When Set 
0 Used internally by RMF post processor 
1-15 Reserved 


Operating system release number and level, in the form 
nnil 


Sampling cycle length in the form OOOttttF, where F is 
the sign (taken from CYCLE option). The range of 
values is 0.050 to 9.999 seconds. 


MVS software level (consists of an acronym and the 
version, release, and modification level numbers) 


Indicates the type of processor complex on which data 
measurements were taken 


Value Meaning 

01 308x or 908x processor 
02 4381 processor 

03 3090 processor 


X’'80’ indicates system has extended storage 


Reserved 


Time when call to data gatherer was issued, in the form 
hhmmsstF, where F is the sign 


Flags 
X’80’ indicates that there are not enough relocate data 
sections to complete data gathering 


Reserved 

RMF session identifier 

Reserved 

Reserved user field 

Measurement name 

Length of command text 

Text of command 

Length of data reporter default text 
Default data reporter text 


Monitor | internal start time 


J 





+0 
+2 


+10 
+12 
+14 


+16 


+20 


+22 


+24 


( +26 
+28 


+0 
+2 


+A 
+C 
+B 


+10 


+14 


+16 


+18 


+1A 
+1C 


R791ASID 
R79 1JBN 


R791DMN 
R79 1NPG 
R791PGP 


R791TTOD 


R791CL 


R791TAS 


R791SRC 


R791DP 
R79 1SEQN 


2 
8 


2 


2 


2 


Sub-type 1 (ASD and ASDJ) Data Section: 


binary 
EBCDIC 


binary 
binary 


binary 


EBCDIC 


binary 


EBCDIC 


binary 
binary 


ASCBASID 


ASCBJBNI pointer 
or ASCBJBNS pointe 


CUCBDMN 
OUCBNPG 
((OUCBPGP 


(LENGTH (WPGD) 
LENGTH (WPGR))) 
/LENGTH(WPGP)) +1 


Set to IN when all 
other indicators are 


off 


OUCBPVL 
OUCBNSW 


OUCBOFF, 
OUCBMWT 
OUCBOFF, 
OUCBTRM 


OUCBOFF, 
OUCBLWT 


OUCBOFF 


OUCBOUT, 


OUCBDLYB 


OUCBLSW 
OUCBOUT 
OUCBGOO 
OUCBGOI 


ASCBJBNI 
OUCBSTT 

OUCBMNT 
OUCBLOG 


OUCBSEC = 1 


through 14 


ASCBDP 





Address space identifier 


Name of job 


Domain number 
Performance group 


Performance group period 


Reserved 


Current location 

Contents Meaning 

IN In storage 

PR Privileged 

NS Non-swappab le 
WM Wait queue/MSO 


WT Wait queue/terminal wait 


WL Wait queue/long wait 


WO Wait queue/reasons other 
than WM, WL, or WT 


DL Out queue/delayed 


LO Logically swapped out 
OT Swapped out and ready 
> > Transitioning out 

<< Transitioning in 

Type of user 
Contents Meaning 
0 Batch 

1 Started task 

2 Mount task 

3 TSO 

Reason for last swap-out 
Contents Meaning 

Tl Terminal input 
TO Terminal output 


LW Long wait 

XS Auxiliary storage shortage 
RS Real storage shortage 
DW Detected wait 

RQ Request swap 

NQ CAP enqueue 

EX CAP exchange 

US CAP uni-swap 

TS Transition 

00 Unknown 

Dispatch priority 


Reserved 


(Continued) 
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Sub-type 1 (ASD and ASDJ) Data Section: (continued) 


binary 
binary 
binary 
binary 
binary 


binary 
binary 


binary 


binary 
binary 
binary 


binary 
EBCDIC 
binary 
binary 
EBCDIC 


binary 


binary 


binary 


binary 


binary 


binary 


binary 


+30 | +1E R791FMCT 2 
+32 | +20 R791WSS 2 
+34 | +22 R79 1SWC 2 
+36 | +24 R79 1SWMR 2 
+38 | +26 R79 1SCRV 2 
+40 | +28 R791SIOC 2 
+42 | +2A R79 1WMS 

+46 | +2E R791TCPU 

+50 | +32 R791SSRV 2 
+52 | +34 R791ES 2 
+54 | +36 R791ESSL 4 
Sub-type 2 (ARD and ARDJ) Data Section: 
+0 +0 R792ASID 2 
+2 +2 R792JBN 8 
+10 | +A R792DMN 2 
+12 | +C R792NPG 2 
+14 | +E R792CL 2 
+16 | +10 R792TAS 2 
+18 | +12 R792TRC 2 
+20 | +14 R792TTOD 4 
+24 | +18 R7S92PRFX 
+28 | +1C R792ARS 2 
+30 | +1E R792SVAR 4 
+34 | +22 R792TCPU 4 
+38 | +26 R792PSS 
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ASCBFMCT Number of real storage frames 
OUCBWSS Working set at last swap-in 
OUCBSWC Transaction swap count 
OUCBWMR/256 SRM work load recommendation value 
OUCBCRV”* SRM processor recommendation value 
RMPTCPU/256 
OUCBIRV* SRM I/O recommendation value 
RMPTIOC/256 
OUCBWMS SRM service for the current transaction since the last swap-in 
ASCBEJST + CPU time (TCB + SRB) for current job step, in milliseconds 
ASCBSRBT 
OUCBSBRV SRM storage recommendation value 
RAXECST Number of extended storage frames used by the job. 


Reserved 





ASCBAS!D 
internal 
OUCBDMN 
OUCBNPG 
OUCBOFL 


Address space identifier 





Name of job 





Domain number 









Performance group 





Current location 





Contents Meaning 























IN In storage 

LO Logically swapped out 
OT Swapped out and ready 
NS Non-swappable 

WM Wait queue/MSO 

WL Wait queue/long wait 
wo Wait queue/reasons other than WM, WL, or WT 
DL Out queue/delayed 

WT Wait queue/terminal wait 
PR Privileged 

>> Transitioning out 

<< Transitioning in 

Type of user 






Contents Meaning 

0 Batch 

1 Started task 
2 Mount task 
TSO 


Transaction count 









OUXBT RC 
RMCTTOD, 
OUCBTMO 
IARXCNTF 


OUCBPSE, 
R792E JST 


R792TSRM, 
R792RTM 
ASCBEJST 
OUCBPSS 









Transaction elapsed time, in milliseconds 







Number of private fixed frames 












Average number of real frames for step 





SRM service absorption rate for step 





Total processor time (TCB + SRB) for step, in milliseconds 





Step product of frame, in milliseconds 











c 


[“offwts [Name [ Length [Format [Source [SSC weriptton 


Sub-type 2 (ARD and ARDJ) Data Section: (continued) 


+38 | +26 R792PSS1 4 binary OUCBPSS1 
+42 |+2A R792PSS2 4 binary OUCBPSS2 
+46 | +2E R792EJNST 4 binary ASCBEJST + 
ASCBSRBT 
+50 | +32 R792TSRM 4 binary OUXBJBS + 
OUXBTARS + 
OUCBWMS 
+54 | +36 R79RTM 4 binary OUXBJBR + 
OUXBTRR + 
RMCTTOD - 
OUCBTMS 
+58 | +3A R792EXCP 2 binary ASCBIOSM + 
OUCBIOSM 
+60 | +3C R792CMNI 4 binary OUXBCAPI 
+64 | +40 R792PNV 4 binary OUXBPIN + 
OUXBPOUT 
+68 | +44 R792PVIO 4 binary OUXBVAMI + 
OUXBVAMO 
+72 |+48 R792FXBL 4 binary IARXCNTF 
+76 |+4C R792PSWP 4 binary OUXBPSIN + 
OUXBSPOT 
+80 | +50 R792LPAI 4 binary OUXBLPAI 
+84 |+54 R792CSAI 4 binary OUXBCAPI - 
OUXBLPAI 
+88 | +58 R792LSQA 4 binary IARXCNTF 
+92 |+5C R792NLQF 4 binary IARXCNTF 
+96 |+5E R792TDEV 4 binary ASCBDCTI 
+100 | +64 R792TWSS 2 binary OUCBTWSS 
+102 | +66 R792PIN 4 binary OUXBPIN 
+106 |+6A R792TRTM 4 binary OUXBTRR + 
. (RMCTTOD — 
OUCBTMS) 
+110 |+6E R792FLG 2 binary ASCBXMEC 


Sub-type 3 (SRCS) Data Section: 
R793AFC binary RCEAFC 
R793CRI binary MCVSTCAI 
R793SQA binary IARXCRMF 
R793CMNF binary RCECOMAL 
R793CMFF binary RCECOMFX 


R793PRFX binary RCETOTFX - 
RCECOMFX + 
|IARXCRMF* 


R793CPUU 2 binary CCVUTICP 


R793D0 2 binary ASCB dispatching 
queue pointed to 
by CVTASCBH 


*RSM service routine 


High order word 
Low order word 


Total processor time, in milliseconds 


Total SRM service for job or session 


Resident time for step, in milliseconds 


EXCP count for step 


Number of common pages for current transaction 


Number of non-VIO pages for current transaction 


Number of VIO pages for current transaction 


Number of fixed frames below 16-megabytes 


Number of pages swapped in and out for current 
transaction 


Number of LPA pages paged in for current transaction 


Number of CSA pages paged in for current transaction 


Number of LSQA fixed frames 
Number of non-LSQA fixed frames 


Total device connect time in milliseconds 


SRM target working set size for this job. 
Page in count 


Transaction residency time 


Flags 


Bit Meaning When Set 
0 On — — indicates cross memory address space 
1-15 Reserved 


Number of available frames 

Highest UIC count 

Number of SQA frames 

Number of frames allocated to the common area 
Number of common (LPA + CSA) fixed frames 


Number of private fixed frames (LSQA + non-LSQA) 


Processor utilization (O - 101) 


Length of ASCB ready queue 
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Toffee [Nemo | tongth | Format [Source | —~S~S~S*~«é into 


Sub-type 3 (SCRS) Data Section: (continued) 


+16 | +10 R793INC 
+18 | +12 R7930UTU 
+20 | +14 R793LCU 
+22 | +16 R793ASMQ 
+24 | +18 R793LPAF 
+26 | +1A R793CSAF 
+28 | +1C R793LPFX 
+30 | +1E R793CSFX 
+32 | +20 R793LSQA 
+34 | +22 R793NLQF 
+36 | +24 | R793LOUT 
Sub-type 4 (SPAG) Data Section: 
+0 +0 R794CMNI 
+4 +4 R794CMNO 
+8 +8 R794CMNR 
+12 | +C R794SWPO 
+16 | +10 R794PSPI 
+20 | +14 R794PSPO 
+24 | +18 R794PRVI 
+28 ] +1C R794PRVO 
+32 | +20 R794PRVR 
+36 | +24 R794VI0O 
+40 | +28 R794AFC 
+42 | +2A R794CRI 
+44 | +2C R794ACRI 
+46 | +2E R794RV1 
+48 | +30 R794LPAI 
+52 | +34 R794CSAI 
+56 | +38 R794LPAR 
+60 | +3C R794CSAR 
+64 | +40 R794TWSS 


*RSM service routine 


2 


NM MO NO WN 


N) 


& 


& F# NM DY NY NY 


& 


binary 


binary 


binary 
binary 
binary 
binary 


binary 


binary 


binary 
binary 


binary 


binary 


binary 


binary 
binary 


binary 


binary 


binary 
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OUCB queue 
pointed to by 
RMCTIQE 


OUCB queue 
pointed to by 
RMCTOTQE 


RCVASMOA 
IARXCRMF* 


IARXCRMF * 
RCECOMAL 


IARXCRMF* 


IARXCRMF* 
RCECOMFX 


IARXCRMF* 


RCETOTFX 

IARXCRMF* 
RCECOMFX 
IARXCRMF * 


OUCBLSW 


RCECOMPI 
RCECOMPO 


SWCTPSDA+ 
SWCTLSES+ 

SWCTLSAX+ 
SWCTPSDE+ 
SWCTPSM 


RCESWPPI 
RCESWPPO 


RCETOTPI + 
RCEVIOPI - 
RCECOMPI 


RCETOTPO + 
RCEVIOPO - 
RCECOMPO 


RCEVIOP! + 
RCEVIOPO 


RCEAFC 
MCVSTCRI 


RCELPAPI 


RCECOMPI - 
RCELPAP\ 


MCVTWSS 





Number of address spaces in storage (SRM in queue) 


Number of address spaces out of storage (SRM out 
queue) 


Reserved 

SRM measure of ASM queue length 
Number of LPA pageable frames 
Number of CSA pageable frames 


Number of LPA fixed frames 
Number of CSA fixed frames 


Number of LSQA frames 


Number of private non-LSQA fixed frames 


Number of address spaces logically swapped out 


System common (LPA + CSA) pages in 
System common (CSA) pages out 
Reserved 


Number of swap-outs 


Number of pages swapped in 
Number of pages swapped out 


Number of private pages (VIO + non-VIO) swapped in 


Number of private pages (ViO + non-VIO) swapped out 


Reserved 


Number of VIO pages (in + out) 


Number of available frames 
Highest UIC count 
Reserved 

Reserved 

System LPA pages in 
System CSA pages out 


Reserved 
Reserved 


Target working set size for the common area 





























+0 
+2 
+10 
+12 
+14 
+16 


+20 


+22 


+24 


+28 
+30 
+32 


+36 


+40 


+44 


+0 
+2 
+A 
+C 
+E 
+10 


+14 


+16 


+18 


+1C 
+1E 
+20 


+24 


+28 


+2C 


R794ERTE 
R7I94EVAL 
R794ESSL 
R794MRTE 


R795ASID 
R795JBN 
R795DMN 
R795NPG 
R795PGP 
R795TTOD 


R795CL 


R795TAS 


R795TROD 


R795TCNT 
R795SWC 
R795CPUS 


R795MSOS 


R795I0CS 


R795WMS 


R794MAGE 






Sub-type 5 (ASRM and ASRMJ) Data Section: 


2 
8 
2 
2 
2 
4 





binary 





binary 
binary 
binary 


binary 


binary 
EBCDIC 
binary 
binary 
binary 
binary 


EBCDIC 


binary 


binary 


binary 
binary 


binary 


binary 


binary 


binary 








MCVMGAGE 
RCEESWRT 
RCEAEC 




















RCENWSF 
+RCEWSDNE 


ASCBASID 
internal 
OUCBDMN 
OUCBNPG 
OUCBPGP 


RMCTTOD - 
OUCBTMO 


Set to IN when all 
other indicators are 
off 





















OUCBOUT 
OUCBNSW 
OUCBMVT 
OUCBLWT 
OUCBT RM 
OUCBOFF 
OQUCBPVL 
OUCBGOO 
OUCBGO| 





ASCBJBNI 
OUCBSTT 
OUCBMNT 
OUCBLOG 


OUXBTRR + 
(RMCTTOD - 
OUCBTMS) 


OUXBT RC 
OUCBSWC 
OUCBCPU 












OUCBMSO 


OUCBIOC 





OUXBTRS + 
OUCBWMS 

















Migration age 





Number of pages sent to extended storage 






Number of extended storage frames not in use 





Reserved 






Number of pages migrated from extended storage to 
auxiliary storage 


Address space identifier 
Name of job 

Domain number 
Performance group 
Performance group period 


Real time into transaction 


Current location 


Contents Meaning 


IN In storage 

LO Logically swapped out 
OT Swapped out and ready 
NS Non-swappable 

WM Wait queve/MSO 

WL Wait queue/long wait 
WT Wait queue/terminal wait 
wO Wait queue/other wait 
PR Privileged 

> > Transitioning out 

<< Transitioning in 

Type of user 
Contents Meaning 

0 Batch 

1 Started task 

2 Mount task 

3 TSO 


Transaction resident time 


Transaction count 
Transaction swap count 


Total processor service for transaction (zeroes when ASID 
is out of storage) 


Total MSO service for transaction (zeroes when ASID is 
out of storage) 


Total 1OC service for transaction (zeroes when ASID is 
out of storage) 


Total service for transaction (zeroes when ASID is out of 
storage) 


(continued } 
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Tore [teow [umwo] rome [oor [Own 


Sub-type 5 (ASRM and ASRMJ) Data Section: (continued) 
+438 | +30 R795TOTL 4 binary OUXBJBS + 












Total service for job or TSO session (zeroes when ASID 


OUXBTRS + is Out of storage) 
OUCBWMS 
+52 | +34 R795TOT 4 binary OUCBWMS Total service for transaction since last swap-in 


+56 | +38 R795SRBS 4 binary OUCBSRB 





Total SRB service for transaction (zeros when ASID is 
out of storage) 


















R796ASID Binary RIBEASID Address space |D of the job that issued the RESERVE 

























R796MAJ EBCDIC | RIBQNAME Major name of the resource 
R796MIN EBCDIC | RIBRNAME Minor name of the resource 
R796JBN EBCDIC | RIBEJBNM Name of the job that issued the RESERVE 








R796VOLS EBCDIC | UCBVOLI Volume serial of the volume against which the 


RESERVE was issued 
The device against which the RESERVE was issued 
Type and status of request for the resource 




















R796UCB 
R796REQ 


EBCDIC 
EBCDIC 


UCBNAME 


RIBESTAT + 
RIBETYPE 


RIBRNMLN 
internal 























R796MINL 
R796FLG 


Binary 






Length of the minor name field (used for reporting) 
Reserve flag byte 

Bit Meaning When Set 

0 ON=device reserved by this CPU 

2 ON=minor name truncated 

3-7 Reserved 


System identifier of the job that issued the RESERVE 








Binary 











R796SID 








EBCDIC 





RIBESYSN 











































Sub-type 7 (SENQ) Data Section: 
+0 +0 R797MAJ 8 EBCDIC | RIBQNAME Major name of resource 
+8 +8 R797MIN ad, EBCDIC | RIBRNAME Minor name of resource 
+52 | +34 R797FLG 1 Binary internal Data type flags 
Bit Meaning When Set 
0 ON=detail data 


OFF=summary data 

ON=major name specified 

ON=minor name specified 

ON=minor name truncated 

Global resource 

Data is for all resources held by a specified system 
in a global resource serialization complex 

Data is for all resources held exclusively by a 
specified system in a global resource serialization 
complex 
Reserved 


oh WN = 


Oo 


7 


























































+53 | +35 | R797MINL 4 Binary RIBRNMLN Length of the minor name field (used for reporting) 
+57 | +39 R7970OWN 2 Binary RIBNTO Count of requestors that own the resource 
+59 | +3B R797EXCW 2 Binary RIBNTWE Count of requestors waiting for exclusive use of a resource 
+61 | +3D R797SHRW 2 Binary RIBNTWS Count of requestors waiting for shared use of a resource 
+63 | +3F R797REQ 2 EBCDIC | RIBETYPE + Type and status of resuest for a resource 
RIBEJBNM (‘SO’,’SW',’EO’ or’ EW’) 
+65 | +41 | R797JBN 8 EBCDIC | RIBEASID Name of the job that issued the ENQ 
+73 | +49 R797ASID 2 Binary RIBEASID Address space ID of the job that issued the ENQ 
+75 | +4B R797SCOP 4 EBCDIC | RIBSCOPE Scope of the resource (‘SYS’,’SYSS’,or ‘STEP’) 
+79 | +4F R797RES 2 EBCDIC Reserved 
+81 | +51 R797S|ID 8 EBCDIC | RIBESYSN System identifier of the job that issued the ENQ 
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c 


[ofteew [Name | tonath [Format | Sowes | ——~—~—~eseintion 


Sub-type 8 (TRX) Data Section: 


+16 


+20 


+30 
+40 
+50 


Sub-type 9 Device Data Section: 


+0 
+2 
+4 
+5 


+12 
+16 
+20 


+24 


+28 


+32 


+0 
+2 
+4 
+6 
+8 
+C 


+10 


+24 


+2E 
+28 
+32 


+0 
+2 
+4 
+5 


+C 
+10 
+14 


+18 


+1C 


+20 


R798ICSI 
R798iPSI 
R798PGN 
R798PGP 
R798SYS 
R798TTX 


R798TTM 


R798CLS 


R798USR 
R798NAM 
R798FL1 


R799NUM 
R799LCU 
R799RVO 
R799CNF 


R799SER 


R799TYP 
R799NUX 
R799SSC 


R799MEC 


R799CNN 


R799PEN 


& B&B NO NY N N 


10 


10 
10 


(one per device) 


2 
2 
1 


EBCDIC 
EBCDIC 
binary 
binary 
EBCDIC 


binary 


binary 


EBCDIC 


EBCDIC 
EBCDIC 


binary 


packed 
binary 
binary 


binary 


EBCDIC 


binary 
binary 


binary 


binary 


binary 


binary 


RMCTICST 
WAMTIPS 
WAMT 
WAMT 
ICSM 
WAMPTRN 


WAMPTET 


ICSM 


ICSM 
ICSM 
WAMPRPT 





EDDDNUM 
EDDDLCUN 


EDDDNQUL 
EDDDNLCD 
EDDDNCMB 


EDDDMXPB 


EDDDCCHG 


EDDDALIV 
UCBVOLI 


internal 
EDDDNUMX 


CMBSSCHC - 
EDDDLSSC + 
EDDDASSC 


CMBSAMPC - 
EDDDLMEC + 
EDDDAMEC 


CMBCONNT - 
EDDDBCNN 


CMBPENDT - 
EDDDBPEN 


Identifier of IEAICSxx parmlib member 
identifier of IEAIPSxx parmlib member 


Performance grqup number 


Performance group period 


Subsystem name associated with the performance group 


Number of ended transactions for the performance 
group period 


Elapsed time (in 1024-microsecond units) for all ended 
transactions in the performance group period 
Transaction class name associated with the performance 
group 


User identifier associated with the performance group 
Transaction name associated with the performance group 
Data type flags 

Bit Meaning When Set 


ON - performance group is a report performance 
group 

OFF - performance group is a control performance 
group 

Reserved 


Device number 

Logical control unit number X’00’ to X’FF’ 
Reserved 

Device flags 


Meaning When Set 

ON = IOS queue-length invalid 

ON = NO logical control unit information 

ON = CMB data invalid 

Reserved 

ON = device is multiple exposure device; this is 
base exposure 

ON = device was reconfigured or DDR activity was 
detected during Monitor | interval 

ON = device is currently online 


Volume serial number of the volume mounted on this 
device 


Device type 
Number of exposures if multiple exposure device 


Start subchannel (SSCH) count 


Measurement event count - number of SSCH instructions 
for which connect, pending, and active times were stored 


Device connect time 


Function pending time 
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| Offsets | Name | Length | Format | Source | Description 


Sub-type 9 Device Data Section: (one per device) (continued) 


+36 | +24 R799ATV 4 
+40 | +28 R799DIS 4 
+44 | +2C R799QUE 4 
+48 | +30 R799UTL 
+52 | +34 R799RSV 4 
+56 | +38 R799DSO 
+60 | +3C R799ALC 
+64 | +40 R799DVB 
+68 | +44 R799CUB 
+72 | +48 R799 ICT 2 
+74 | +4A R799RES 2 


Sub-type 10 (DDMN) Data Section: 


binary 


binary 


binary 


binary 


binary 


binary 


binary 


binary 
binary 


binary 


EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
binary 

binary 


binary 


+0 | +0 R79ATWSR 4 
+41 +4 R79AMPLT 2 
+6 | +6 R79ARUA 2 
+8 | +8 R79AGOOU 2 
+10 | +A R79ACMPL 2 
+12 | +C R79AOUTU 2 
+14 | +E R79AINCU 2 
+16 | +19 | RIQATCTL 2 
+18 | +12 R79ACIDX 2 
+20 |} +14 | R79ANSW 2 
+22 | +16 | R79ADMNO- 1 
+23 | +17 R79RESV1 1 
+24 | +18 R79RESV2 1 
+25 | +19 | R79ATYPE 1 
+26 |+1A | R79AIPS 2 
+28 | +1C R79ACPU 4 
+32 | +20 R79A10S 4 
+36 | +24 R79AMSO 4 
+40 | +28 R79ASRB 4 
+44 |+2C | R79ATWET 4 
+48 | +30 | R79ADMLO 2 
+50 | +32 R79ADMHI 2 
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CMBACTVT - 
EDDDBATV 


CMBACTVT - 


(CMBPENDT + 


CMBCONNT) 
EDDDNENQ 
EDDDBUSY 


EDDDRESV 


EDDDDSOP 
EDDDALOC 


SCHMDTDB 
SCHMDTCB 


J\OCSTSQE 
(1OS Service) 


DMDTTSWR 
DMDTMPLT 
DMDTRUA 
DMDTGOOU 
DMDTCMPL 
DMDTOUTU 
DMDTINCU 


DMDTWT 
DMDTAOBJ 
DMDTDOBJ 
DMDTFWKL 


DMDTCIDX 
DMDTNSW 
DMDTNO 


DMDTWT 
DMDTAOBJ 
DMDTDOBJ 
DMDTFWKL 


WMSTiD 
WMSTIPC 
WMSTIPI 
WMSTIPM 
WMSTIPB 
DMOTTWET 
DMDTLO 


DMDTHI 





Function active time 


Device disconnect time 


Number of requests queued in JOS for this device 


Number of samples when the device was reserved but an 
SSCH had not been issued to the device 


Number of samples taken during the measurement inter- 
val that indicated that the device was reserved 


Total number of data sets open on the device 


Number of samples taken during the measurement inter- 
val that indicated that the device was allocated. 


Device busy delay time (for the 3090 processor only) 
Control unit busy delay time (for the 3090 processor only) 


Invalid sample count for the 3090 processor only) 


Reserved 


Time-weighted average service rate for this domain 
Multiprogramming level target 

Average number of ready users 

Average number of users being swapped out 
Current MPL value 

Average number of users swapped out 

Average number of swapped-in users 

Target control value 


Contention index 

Number of non-swappable users 
Domain number 

Reserved 

Reserved 


Type of MPL target control 

W — weighting factor 

A — performance objective AOBJ 
D — performance objective DOBJ 
F — performance objective FWKL 


Current IEAIPSxx member 

CPU service coefficient 

1/O service coefficient 

MSO service coefficient 

SRB service coefficient 

Average first period TSO transaction response time 
Minimum multiprogramming level (MPL) 


Maximum multiprogramming level (MPL) 


J 





“ortets [Name [Length [Format [Source [——~S~S~Ct erin 





Sub-type 11 (PGSP) Control Section: There is one control section followed by a data set section for each data set in the report. 


EBCDIC 












Internal Type of data that follows: 


P — PAGE data sets 
S — SWAP data sets 













Reserved 






Sub-type 11 (PGSP) Data Set Section: 
+0 +0 R79BSALC 4 
+4 +4 R79BSAVL 4 
+8 +8 R79BSLBD 4 
+12] +C R79BSUSE 4 

4 

4 

1 





EPGDSALC 
PARESLTA 
EPGDSLBD 
EPGDSUSE 
IORSION 
IORTREQ 


binary Number of slots/sets in this data set 





binary Number of slots/sets available 





binary Number of bad slots/sets 





binary Number of samples that indicate ASM is using the data set 









+16 | +10 R79BSIOS 
+20 | +14 R79BREQS 
+24 | +18 R79BFLG 


binary Number of SSCH instructions issued for the data set 





binary Number of pages transferred to/from the data set 





binary Flags 


Meaning When Set 

Indicates that the data set is bad 

Indicates a PLPA data set 

Indicates a common data set 

Indicates a duplex data set 

Indicates a local page data set 

Indicates a paging data 

Indicates swapping data 

Indicates that the data set accepts VIO pages 


EPGDSBAD 
EPGDPLBA 
EPGDCOMM 
EPGDDPLX 
EPGDLOCL 
Internal 
Internal 












NQOof WN OD 
> 












+25 | +19 R79BDEV 1 
+26 | +1A R79BDADR 3 
+29 | +1D R79BVSER 6 
+35 | +23 R79BDSN 4s, 
+79 | +4F R79BFL2 1 


EPGDDEV 
EPGDDADR 
EPGDVSER 
PGDSN 


binary 
EBCDIC 
EBCDIC 
EBCDIC 


Device type 





Device number 





Volume serial number 





Data set name 


binary Flags 


Bit (Meaning When Set 

0 Multiple exposure device 

1 Alternate control unit device 
2-7 Reserved 


+80 | +50 R79BRESV 12 binary Reserved 
Sub-type 12 Channel Path Data Control Section: (one per record) 


R79CSMP CPTSAMP 








binary 














Number of samples as weighted by SRM 


Sub-type 12 Channel Path Data Section: (one per channel path) 
+0 +0 R79CPID 1 binary internal 
+1 +1 R79CFG2 1 binary 1IOCDS 


Channel path identifications 





Channel flags 





Bit Meaning When Set 


0 Reserved 

1 Reserved 

2 Block multiplexor 
3 Byte multiplexor 


4-7 


Reserved 


Reserved 





+2 +2 R79CRV3 
+4 +4 R79CBSY 4 binary CPMTBUSY 





Number of SRM samples in which the channel path was 
busy 


Chapter 6. SMF Records 6-209 


[offsets [Name | Length [ Format [| Source 


Description 


Sub-type 13 1/O Queuing Configuration Control Section for 308x, 908x, and 4381 processors: (one per logical control unit described 
by triplet (SMF79DCS) 


+0 


+2 
+4 


+8 
+10 


+0 


+2 
+4 


+8 
+A 


R79DID1 


R79DNTR 
R79DCPDS 


R79DCPDL 
R79DCPDN 


binary 


binary 


binary 


binary 


binary 


EIOQLCUN 


internal 


internal 


internal 


EIOQCHPN 


Logical control unit identifier 


Number of triplets following 


Offset to 1/O queuing configuration data section relative 
to beginning of I/O queuing configuration control section 


Length of 1/O queuing configuration data section 


Number of I/O queuing configuration data sections for 
LCU 


Sub-type 13 I/O Queuing Configuration Data Section for 308x, 908x, and 4381 processors: (one per channel path within a logical 
control unit, described by triplet R79DCPDS) 


R79DCPID 
R79DCPST 


R79CUN 

R79DCU1 
R79DCU2 
R79DCU3 
R79DCU4 


1 
1 


2 
2 
2 
2 
2 


binary 


binary 


binary 
binary 
binary 
binary 


binary 


EIOQCHPN 
ElIOQCPST 


EIOQCUN 
ElOQCU 
ElIOQCcU 
ElIOQCU 
ElOQCU 


Channel Path Identifier 
Channel Path Status 


Meaning When Set 

Channel path installed 

Channel path online 

Channel path varied 

Channel path offline to all devices of the LCU 
Channel path connection to devices of the LCU 
altered by VARY PATH processing 

5-7 Reserved 


WN OD 
~ 


Number of control units attached 
First control unit identifier 
Second control unit identifier 
Third control unit identifier 


Fourth control unit identifier 


Sub-type 13 1/O Queuing Data Section for 308x, 908x, and 4381 processors: (one per logical control unit, described by triplet 


+0 +0 
+1 +1 
2° | 42 
t4 +4 
+6 +6 
+8 +8 
+10 | +A 
SMF79ASS) 
+0 +0 
+1 +1 
2 |), 2 
+4 +4 
+8 +8 
+12) +C 
+16 | +10 
+20 | +14 
+24 | +18 
+28 | +1C 
+30 | +1E 
6-210 


R79DDST 


R79DICT 
R79DABY 


R79DTIS 
R79DSIS 
R79DCUB 


R79DDVB 


R79DQUE 


R79D1D2 


binary 


binary 


binary 


binary 
binary 


binary 


binary 


binary 


binary 
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EIOQNCPS 


EIOQICNT 
EIOQABY 


EIOQATIS 
EIOQASIS 
EIOQACUB 


EIOQADVB 


EIOQQAQUE 


EIOQLCUN 


Reserved 
Data status 


Bit Meaning 

0 No STCPS data available 

1 Reserved 

2 No hardware measurements available 
3-7 Reserved 


Count of invalid samples 


Number of samples when all channel paths in the LCU 
were busy 


Number of initial selection attempts 
Number of successful initial selections 


Number of initial selection attempts unsuccessful due to 
control unit busy 


Number of initial selection attempts unsuccessful due to 
device busy 


Number of requests queued for the LCU (accumulated at 
initial selection time) 


Logical control unit identifier 
Reserved 








c 


| ortests | Name | Length] Format | Source |Description 


Sub-type 14 1/O Queuing Control Section for 3090 Processors (described by triplet SMF79QSS) 
+0 +0 R79EGFLG 1 Global |OQ status 


Bit Meaning when set 

0 Data invalid—channel measurement facility failed 
1 Diagnose interface failure 

2-7 Reserved 


+1 +1] 3 Reserved 


+4 +4 R79EGSAM 4 binary CMPTSAMP CMPT sample count 


Sub-type 14 I/O Queuing Configuration Control Section for 3090 processors: (one per logical control units described by triplet 
SMF79DCS) 


+0 +0 R79EID1 2 EBCDIC lOCDS Logical control] unit identifier 
+2 TZ R79ENTR 2 binary internal Number of triplets following 
+4 +4 R79ECPDS 4 binary internal Offset to 1/O queuing configuration data section relative 
to beginning of |/O queuing configuration control section 
+8 +8 R79ECPDL 2 binary internal Length of I/O queuing configuration data section 
+10 | +A R79ECPDN 2 binary internal Number |/O queuing configuration data sections for 
the LCU 


Sub-type 14 I/O Queuing Configuration Data Section for the 3090 processor: (one per channel path within a logical control unit. 
Described by triplet R79ECPDS) 


+0 +0 R79ECPID 1 binary lIOCDS Channel path identifier 
+1 +1 R79ECPST 1 binary internal Channel path status 
Bit Meaning when set 
0 Channel! path installed 
1 Channel path online 
2 Channel path varied 
3 Channel path offline to all devices of the LCU 
4 Channel path connection to devices of the LCU 
altered by VARY PATH processing 
5-7 Reserved 
+2 +2 R79ECUN 2 binary 1OCDS Number of control units attached 
+4 +4 R79ECU1 2 binary 1IOCDS First control unit identifier 
+6 +6 R79ECU2 2 binary lIOCDS Second control unit identifier 
+8 +8 R79ECU3 2 binary 1OCDS Third control unit identifier 
+10 | +A R79ECU4 2 binary IOCDS Fourth control unit identifier 
+12 | +C R79ECUB 4 binary HSA Number of initial selection attempts that were 
unsuccessful because control unit was busy 
+16 | +10 R79EPT 4 binary HSA Number of I/O operations accepted on this channel path 
+20 | +14 R79EPB 4 binary CMPTBUSY Number of samples when channel path was busy 


(total samples is R7QEGSAM). 


Sub-type 14 I/O Queuing Section for the 3090 processor: (one per logical control unit, described by triplet SMF79ASS) 
+0 +0 R79EID2 2 EBCDIC | |OCDS Logical control unit identifier 
+2 +2 R79EDST 1 binary Data status 

Bit Meaning when set 


0 Reserved 
1 No hardware measurements available 
2-7 Reserved 


+3 +3 1 Reserved 
+4 +4 R79EQSM 4 binary HSA Accumulated length of CU-HDR queue 
+8 +8 R79EQCT 4 binary HSA Number of entries placed on the CU-HDR queue 
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Record Type 80 (50) — RACF Processing Record 
Record Type 81 (51) — RACF Initialization Record 


Record types 80 and 81 are written by RACF during RACF initialization and 


processing. For information about record types 80 and 81, refer to SPL: Resource 
Access Control Facility (RACF): Installation Reference Manual, SC28-1343. 
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6-214 


Record Type 82 (52) — Security 


Record type 82 is a security record used to record information about the events 
and operations of the Programmed Cryptographic Facility Program Number 
(5740-XY5). The record length is 45 bytes plus the length of the variable 
relocate sections. 


Record type 82 is written to the SMF data set at the completion of each of the 
following cry ptography functions: 


e Initialization. 
The record is written when the Programmed Cryptographic Facility is 


initialized, either when cryptography is started or as a part of the key 
generator utility program. 


e Start. 


The record is written by ICTMKMO1 when a START command is issued for 
cryptography. 


@ Stop. 


The record is written by ICTMKMO1 when a STOP command is issued for 
crytopgraphy. 


e@ Generation of an operational key. 


If specified in the initialization options for cryptography, ICTMKM04 
writes a record after processing each GENKEY macro instruction. 


e Transformation of an operational key. 


If specified in the initialization options for cryptography, ICTMKM04 wnites 
the record after processing each RETKEY macro instruction. 


e@ Execution of the key generator utility. 


The record is written by ICTMKGO0 after the execution of the key generator 
utility program, thus providing a record of changes to the cryptographic key 
data set (CKDS). 


Record type 82 consists of a header section and five possible relocate sections. 
The header section identifies the RACF user ID and group name or the job and 
step name of the non-RACF cryptography user, the cryptography function that 
the record describes, and the return code issued by the function. The header 
section is 45 bytes long. 


System Management Facilities (SMF) 


J 





The five possible variable relocate sections are: 


@ Key generator utility, which indicates changes made by the utility to the host 
system master key, the local keys, the cross keys, and the remote keys. The 
length of the section is 6 bytes. 


e GENKEY function, which indicates the action taken in response to a GENKEY 
macro instruction. The length of the section is 27 bytes. 


e@ RETKEY function, which indicates the action taken in response to a RETKEY 
macro instruction. The length of the section is |1 bytes. 


e@ Cryptography initialization, which describes the SMF recording options in 
effect at initialization and the cryptography function and key manager user 
SVC numbers. The length of the section is 7 bytes. 


e Installation data, which contains any information supplied by an installation 
user exit routine. The maximum length of the section is 66 bytes. 


Note: The number of relocate sections depends on the type of action taken. For 
instance, the record written when the Programmed Cryptographic Facility stops 
consists only of the header section. When the Programmed Cryptographic 
Facility has previously been initialized within the same IPL, the record written 
when cryptography starts also consists of only the header section. The number of 
relocate sections is indicated in CRY82VCT (offset 37). 


Using the ICTSMF82 and ICTCRY82 macros: Because record type 82 cannot be 
mapped using the IFASMFR macro, you must use two mapping macrus to 
symbolically address record type 82. The macros are supplied on SYS1.MACLIB. 
ICTSMF82 maps the fields in record type 82 whose name starts with SMF. For the 
Programmed Cryptographic Facility, ICTSMF82 maps the fields addressed by 
offsets X‘0’ through X*16’. ICTCRY82 maps the fields in record type 82 whose 
name starts with CRY. For the Programmed Cryptographic Facility, ICTCRY82 
maps the fields addressed by offsets X‘18’ through X‘2C’ and the variable relocate 
sections. 


The format is: 


ea [ae at age $$ soronon 


ee 
| SMFs2seG | 2 | binary internal 


SMF82FLG binary oe 83 Bit | Meaning When Set 
Reserved 
5 MVS/XA 
6 VS2 
7 VS1 


rs_[8_| swreaary | 1 [binary linea | Records OOS 


SMF82TME binary |SVC 11 or Time, in hundredths of a second, record was moved to 
SVC 83 the SMF buffer 

SMFS82DTE oacked {SVC 11 or Date record was moved to the SMF buffer, in the form 
SVC 83 OOYYDODF where F is the sign 

SMF82SID JMRCPUID or System identification (taken from S!D parameter) 
SMCASID 


ria_[72_[SMFeaLNG | 4 [binary invernet | Length of record hesder SSCS 


(Continued) 
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[_Otwwn | Nemo [Lenth| Former | Source | Description 
binary Security product identifier: X‘0001’ for Programmed 
Cryptographic Facility (Program number 5740-X Y5) 


Jobname or, for RACF users, userid 


TIOCNJOB 
in TIOT or 
ACEEUSAI 


CRY82USR 
in ACEE 
CRY82GRP TIOCSTEP 
in TIOT or 
ACEEGREPN in 
ACEE 









Stepname or, for RACF users, RACF group name. 





CRY82 FLG binary 
1-7 


Meaning When Set 

Fields CRYSZ2USR and CRY82GRP 
contain RACF user |D and group name. 
(When this bit is off, the fields contain the 
job name and step name.) 

Reserved 





CRY82VCT a a Number of variable relocate sections 


CRY82FTN binary Function code 
| Code Meaning 


- Generator Utility Relocate Section: 


Key generator function 
GENKEY function 
RETKEY function 
Start cryptography 
Stop cryptography 





2C | CRY82RTC Return code issued by function or X’FF’ if function 
| terminated abnormally 


CRY82DTP binary 





Data type indicator: X’0O1° for key oe¢ 


fr [[envezoun [fare ircaoo | ung et ne ine 


CRY82SMK ICTMKGOO Host system master key flags 
Bit 
0 
1-7 Reserved 


Bit 
0 
1 
2 


3-7 


: 7 | 
; 7 | 
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_ 
+4 CRY82CMK Cross key flags 
| Bit I 

0 

1 

2 

_ 


Meaning When Set 
Host system master key was successfully 
changed 


Local key flags 
Meaning When Set 


At least one local key was updated 

At least one local key was added 

At least one local key was deleted from 
the CKDS 

Reserved 


Meaning When Set 


At least one pair of cross keys was updated 
At leest one pair of cross keys wes added 
At least one pair of cross keys was deleted 
from the CKDS 

Reserved 


Remote key flags 


Meaning When Set 

At least one remote key was updated 

At least one remote key was added 

At least one remote key was deleted from 
the CKDS 

Reserved 





(Continued) 
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nd 
GENKEY Function Relocate Section: 
= CRY82DTP binary ICTMKM04 Data type indicator: X‘02’ for GENKEY function 


CRY82DLN -——s ICTMKMO04 Length of the data that follows 


CRY82GFG binary ICTMKMO04 GENKEY activity flags 

Bit Meaning When Set 

0 ‘LOCKEY’ parameter was in error 

1 ‘LOCKEY2’ parameter was in error 

2 ‘“REMKEY’ parameter was in error 

3 ‘OPKEY’ was generated by the key manager. 
When bit 3 is off, ‘OPKEY’ was supplied to 
the key manager. 
Installation data relocate section was omitted 
from this record because the data supplied by 
installation exit exceeded the length of 
CRY82!D (64 bytes) 

5-7 Reserved 


CRY82LK1 EBCDIC | GENKEY ‘LOCKEY’ key name 
LOCKEY 
| parameter 
+11 CRY82LK2 EBCDIC | GENKEY ‘LOCKEY2’ key name 
LOCKEY2 
| parameter | 
+19 CRY82REM EBCDIC | GENKEY ‘REMKEY’ key name 
REMKEY 
parameter 


RETKEY Function Relocate Section: | 
+0 CRY82DTP 1 binary ICTMKM04 Data type indicator: X‘Q3' for RETKEY function 
- }+1 | | CRY82DLN | 1 [binary |ICTMKMO4 Length of the data that follows 


CRY82RFG | binary ICTMKM04 RETKEY activity flags 
| Bit Meaning When Set 
6) Installation data relocate section was omitted 
| from this record because the data supplied by 
the installation exit exceeded the length of 
CR Y82ID (64 bytes) 
1 Reserved 


CRY82RKN EBCDIC | RETKEY "REMKEY’ key name 
REMKEY 
parameter 


Cryptography Initialization Relocate Section: 


CRY82DTP i ICTMKGOO Data type indicator, X‘04’ for initialization 
ICTMKMO1 


CRY82DLN binary | ICTMKGOO Length of the data that follows 
ICTMKMO1 


+2 CRY8S2SMF binary ICTOPTNS SMF option flags 
Bit Meaning When Set 
SMF records not written for GENKEY 
function 
SME records not written for RETKEY 
function 
Reserved 


+3 CRY82SIM binary |ICTOPTNS Cryptography function user SVC number 
in the form X‘cccc’ 
lat CRY82KMG i. er | ICTOPTNS Key manager user SVC number in the form 
| X’cecc’ 























L 
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Installation Data Relocate Section: 


CRY82DTP ICTMKGOO, 
ICTMKMO04 


eT —_ aul 
we _ i ol 
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ICTCKG9O, 
ICTMGR9O, 


ICTMGR95 
ICTCKG9O, 


ICTMGRS9O, 
ICTMGR95 


Data type indicator: X‘05’ for instailation 
data 


Length of the data that follows 


Installation data written by an installation user 
exit routine. The maximum length is 64 bytes. 














Record Type 82 (52) — Security 


Record type 82 is a security record used to record information about the events 
and operations of the Cryptographic Unit Support Program Number (5740-XY6). 
The record length is 41 bytes plus the length of the variable relocate sections. 
Record type 82 is also written by the Programmed Cryptographic Facility 
(5740-XY5). 


Record type 82 is written to the SMF data set at the completion of each of the 
following cryptography functions: 
e Initialization. 
The record is written when the Cryptographic Unit Support is initialized, either 
when cryptography is started or as a part of the key generator utility program. 
e Start. 
The record is written by ICUMKM11 when a START command is issued for 
cryptography. 
e Stop. 
The record is written by ICUMKM11 when a STOP command is issued for 
cryptography. 
e Modify. 
The record is written by ICUMKM11 when a MODIFY command is issued for 
cryptography. 
e Unit check. 


The record is written by [CUMKM11 when the cryptographic unit is switched 
offline and then brought online again. 


e Generation of an operational key. 
If specified in the installation options for cryptography, ICUMKM14 writes 
a record after processing each GENKEY macro instruction. 

e Transformation of an operational key. 
If specified in the installation options for cryptography , ICUMKM14 writes 
the record after processing each RETKEY macro instruction. 

e Execution of the key generator utility. 


The record is written by ICUMKG10 after the execution of the key generator 
utility program, thus providing a record of changes to the cryptographic key 
data set (CKDS). 


Record type 82 consists of a header section and six possible relocate sections. 
The header section identifies the RACF user ID and group name or the job and 
step name of the non-RACF cryptography user, the cryptography function that 
the record describes, and the return code issued by the function. The header 
section is 45 bytes long. 
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The six possible variable relocate sections are: 


e Key generator utility, which indicates changes made by the utility to the host 
system master key, the local keys, the cross keys, and the remote keys. The 
length of the section is 6 bytes. 


e GENKEY function, which indicates the action taken in response to a GENKEY 
macro instruction. The length of the section is 27 bytes. 


@ RETKEY function, which indicates the action taken in response toa RETKEY 
macro instruction. The length of the section is 11 bytes. 


e Cryptography initialization, which describes the SMF recording options in 
effect at initialization and the cryptography function and key manager user 
SVC numbers. The length of the section is 7- bytes. 


e Installation data, which contains any information supplied by an installation 
user exit routine. The maximum length of the section is 66 bytes. 


e Cryptographic unit data, which indicates the status of the cryptographic unit. 
The length of the section is 6 bytes. 


Note: The number of relocate sections depends on the type of action taken. For 
instance, the record written when the Cryptographic Unit Support stops consists 
only of the header section. The number of relocate sections is indicated in 
CRY82CVT (offset 41). 


Using the ICUSMF82 and ICUCRY82 macros: Because record type 82 cannot be 
mapped using the IFASMFR macro, you must use two mapping macros to 
symbolically address record type 82. The macros are supplied on SYS1 MACLIB. 
ICUSMF82 maps the fields in record type 82 whose name starts with SMF. For the 
Cryptographic Unit Support, ICUSMF82 maps the fields addressed by offsets X‘0’ 
through X‘16’. ICUCRY82 maps the fields in record type 82 whose name starts 
with CRY. For the Cryptographic Unit Support, ICUCRY82 maps the fields 
addressed by offsets X‘18’ through X‘2C’ and the variable relocate sections. 


The format is: 


Se eee 
0 | 0 | smre2ten | 2 [binary internal | Recordtength 
[2 [2 | swrezses [2 [binary [imernat | Seument deserter 


| SMF82FLG ia SVC 83 Sicrarnindicatee 


refs | swrazary | 1 [binary [invornat | —Recordype SOS 


SMF82TME binary |SVC 11 or Time, in hundredths of a second, record was moved to 
SVC 83 the SMF buffer 
SMF82DTE packed |SVC 11 or Date record was moved to the SMF buffer, in the form 
SVC 83 O0OYYDDDF where F is the sign 
EBCDIC | JMRCPUID or System identification (taken from SID parameter) 
SMCASID 


rie [aa [swraaine [4 [binary ineernat | _Uangeh of recordheager——SSSOSCSC~—S 


(Continued) 


















Bit Meaning When Set 


0-5 Reserved 
6 VS2 
7 Vsi1 
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SMF82T!ID binary Security product identifier: X ‘0002’ for Cryptographic 
Unit Support (Program number 5740-X Y6) 


CRY82USR EBCDIC | TIOCNJOB Jobname or, for RACF users, userid 

in TIOT or 

ACEEUSAI 

jin ACEE 
CRY82GRP EBCDIC  TIOCSTEP Stepname or, for RACF users, RACF group name. 

in TIOT or 

| ACEEGRPN in 

ACEE 


CRY82FLG binary _ 
Meaning When Set 
Fields CRY82USR and CRY82GRP 
contain RACF user |D and group name. 
(When this bit is off, the fields contain the 
job name and step name.) 
-7 Reserved 


) 41 | 29 | CRY82VCT | 2 [binary finternal Number of variable relocate sections 


CRY82FTN binary Function code 
Code Meaning 
Key generator function 
GENKEY function 
RETKEY function 
Start cryptography 
Stop cryptography 
Modify cryptography 
7 Hardware check 


2C CRY82RTC binary Return code issued by function or X‘FF’ if function 
Seow terminated abnormally | 
Key Generator Utility Relocate Section: vassiaa _| 
+0 CRY82DTP 1 binary {| ICUMKG10 Data type indicator: X‘O1’ for key generator utility 


de CRY82DLN 1 | binary iICUMKG10 Length of the data that follows 


CRY82SMK binary ICUMKG10 Host system master key flags 
Bit Meaning When Set 
0 Host system master key was changed. This bit 
is set even if an error occurs in the key generator. 
1-7 Reserved 
CRY82LMK binary  \CUMKG11 Local key flags 
Bit Meaning When Set 
0 At least one local key was updated 
1 At least one local key was added 
2 At least one local key was deleted from 
the CKDS 
3-7 Reserved 
CRY82CMK binary | ICUMKG11 Cross key flags 
Bit Meaning When Set 
0 At least one pair of cross keys was updated 
1 At least one pair of cross keys was added 
2 At least one pair of cross keys was deleted 
from the CKDS 
3-7 Reserved 
CRY82RMK binary ICUMKG11 Remote key flags 
Bit Meaning When Set 
At least one remote key was updated 
At least one remote key was added 
At least one remote key was deleted from 
the CKDS 
Reserved 
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(Continued) 


[oe [vom fem] eee 
GENKEY Function Relocate Section: 
ce CRY82DTP binary ICUMKM14 Data type indicator: X‘02’ for GENKEY function 


_CRY82DLN 5 ICUMKM14 Length of the data that follows 


CRY82GFG binary ICUMKM14 GENKEY activity flags 

Bit Meaning When Set 

0 ‘LOCKEY’ parameter was in error 

1 ‘LOCKEY2’ parameter was in error 

2 ‘REMKEY’ parameter was in error 

3 ‘OPKEY’ was generated by the key manager. 
When bit 3 is off, ‘OPKEY’ was supplied to 
the key manager. 
Installation data relocate section was omitted 
from this record because the data supplied by 
installation exit exceeded the length of 
CRY82ID (64 bytes) 

- Reserved 


CRY82LK1 EBCDIC | GENKEY “LOCKEY’ key name 
LOCKEY 
parameter 

CRY82LK2 EBCDIC | GENKEY ‘LOCKEY2’ key name 
LOCKEY2 
parameter 

+19 CRY82REM EBCDIC | GENKEY “REMKEY’ key name 

REMKEY 
parameter 


RETKEY Function Relocate Section: 
+0 CRY82DTP binary ICUMKM14 Data type indicator: X‘03’ for RETKEY function 


}+1 | | CRY82DLN —— ICUMKM14 Length of the data that follows 


+2 CRY82RFG i ICUMKM14 RETKEY activity flags 
Bit Meaning When Set 
0 Installation data relocate section was omitted 
from this record because the data supplied by 
the installation exit exceeded the length of 
CRY82ID (64 bytes) 
- Reserved 
+3 


CRY82RKN EBCDIC | RETKEY ‘REMKEY’ key name 
REMKEY 
parameter 


Cryptography Initialization Relocate Section: 
CRY82DTP 
































ICUMKG10 
ICUMKM11 


+1 CRY82DLN binary ICUMKG10 Length of the data that follows 
ICUMKM11 


+2 CRY82SMF binary ICUOPTN2 SMF option flags 
Bit Meaning When Set 
SMF records not written for GENKEY 
function 
SMF records not written for RETKEY 
function 
- Reserved 


+3 CRY82SIM binary ICUOPTN2 Cryptography function user SVC number 
in the form X’cccc’ 
ere CRY82KMG Ea binary | ICUOPTN2 Key manager user SVC number in the form 
X‘cece’ 


Data type indicator, X‘04’ for initialization 








(Continued) 
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[ores [vane [imoea[ rome] see [Omer 
installation Data Relocate Section: 
oT eer [te 

ICUMGRSO, 


+1 CRY82DLN 
ICUMGR95 
+2 CRY82ID VAR | EBCDIC | ICUCKGS90O, 
ICUMGRSO, 
ICUMGR95 


Cryptographic Unit Data Relocate Section: 


CRY82DTP binary |ICUMKG10 
ICUMKG04 
ICUMKM11 
+1 CRY82DLN binary | ICUMKG10 
ICUMKGO04 
aa _ ai 

























ICUMKG10, 
ICUMKM14 


ICUCKG90, 


Data type indicator: X‘0O5S’ for installation 
data 











Length of the data that follows 













Installation data written by an installation user 
exit routine. The maximum length is 64 bytes. 
















Data type indicator: X‘06’ for Cryptographic 
unit data 












Length of the data that follows 


ICUMKM11 


ICUMKG10 
ICUMKG04 
ICUMKM11 


ICUMKG10 









Cryptographic unit address 














Cryptographic unit status 







Reserved 


+§ CRY82CST binary 
ICUMKGO04 . . 
ICUMKM11 Bit Meaning when set 
0 Unit is online and available 
1 Unit is unavailable 
2 Unit check-key verification failed 
3 Unit check-key verification successful 
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Record Type 90 (SA) — System Status Record 


Record type 90 is written whenever certain operator commands are issued. The 
record is created for operator tracking and reporting of reliability data and allows 
the installation to establish availability statistics. The following list of commands 
causes the associated module to write the record: 


Command Module Command Module 
SET TIME IEE6503D HALT EOD IEE70110 
SET DATE IEE6503D SET OPT IEEMB8 12 
SETDMN IEE8603D SET ICS IEEMB8 12 
SET IPS TEEMB8 12 SETSMF IEEMB823 
SET SMF IEEMB823 SET MPF IEECB805 
SWITCH SMF IEEMB829 SET DAE ADYTRNS 


In addition, the record is written by IEEMB823 during IPL processing. 
The record length is variable. 


Note: The subtype indicator is defined at offset 0 in the product section. 
The format is: 












Wane [usngth | Former [Source *([—~S~*~CS eign SSS 
To [0 | swroouen | 2 | vinery [ines | Recording SSS 
Ta [4 | smroorus | 1 | binay [svces | Header flagbyte SSS 
ss _[swrconty | 1 | binary [internat | Record ype 


SMFS0TME binary SVC 83 Time, in hundredths of a second, record was moved 
to SMF buffer 
A SMF90DTE packed | SVC 83 Date record was moved to SMF buffer, in the form 
OOY YDDDF, where F is the sign. 
| 14 | © | smrgosip | 4 | | SMCASID System identification (taken from the SID parameter.) 
pia [iz] 2 | binary [internal sd Reserved 


laa led SMFSOPOF (cca "usasskal \cancicg Offset to product section from start of record, including 
the RDW 


| 24 | 18 | SMF9OPLN Length of product section 
SMF9OPON Number of product sections 


the RDW 


SMF9ODLN | 2 | binary |internal_ Length of data section 
SMF9ODON Number of data sections 


Product Section: 
SMFS90TID 


Offset to data section from start of record, including 






















Sub-type identifier 











1 SET TIME 7 7 HALT EOD 12 SET ICS 

2 SET DATE 8 IPL PROMPT 13 SETSMF | 

3 SETDMN2 9 IPL SMF 14 SET MPF 

4 SET IPS 10 IPLSRM 15 SET SMF (to 
5 SET SMF 11 SET OPT restart SMF) 
6 SWITCH SMF 16 SET DAE 


/ 42 | | SMF9ORVN EBCDIC| internal | —_—«|.- Record version number2 


‘subtype 2 is written only if the CLOCK parameter is not specified on the SET DATE command. Any SET DATE command 


that uses the CLOCK parameter produces a subtype 1 record. 


2Programs that need to handle sub-type 3 (SETDMN) records from Release 1.3 and earlier releases can look at SMFSORVN to 
determine which lengths and offsets to use. This field contains X‘02’ if the sub-type 3 record was produced by Release 1.3 and 
X‘O1' if it was produced by an earlier release. 
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[orimn [vane [unm [rome | sowme [On 


Self-Defining Section: For subtype 5, 9, 13, and 15 only! 


SMFSOOSM i internal Offset to IPL SMF or SET SMF section from start of 
record, including the ROW 


i al I Ms 


(+6 | 6 |SMFoonsm| 2 [binary internal |_ Number of IPL SMF or SET SMF sections 


SMFSOODA binary internal Offset to data section from the start of record, 
including the RDW 


P+12 | c | SMFSOLDA | 2 | binary | ‘binary | Length of data set section 
(+14 | & | SMF9ONDA a3 Number of data set sections 


+16 binary Offset to subsystem section from the start of the 
record, — tor. ing re RO the ROW 


+20 | 14 | SMFSOLWK | 2 | binary | binary | Length of subsystem section = it” of subsystem section 
aC ea Number of subsystem sections 

| +24 [18 | SMF9000T| 4 [binary [internal ——|_Offset to subsystem parameter segment 
SMFSOLOT | 2 | binary |internat = |[ Length of subsystem parameter segment 
(+30 | 1€ | smFgonoT| 2 | binary [internal —_—|_ Number of subsystem parameter segments 


IPL SMF/SET SMF/SETSMF Sections (Subtypes 5, 9, 13, and 15): 
SMFSOMAX 4 EBCDIC | SMCAMDM Current value for MAXDORM in MMSS format 


Tre [4 [eursosta |e escore |sucassrs | caren wae for STATUS in HEMMGS format 
[10 [a [swroowr | [escoic|smcaswT | Current value for JWT in the format hmmm 
ra |e [smraasvi | [escoic|swcasio | Svatem identification 
Tre [12 _[smrooaur [1 [binary [SMCAMNBF | Minimum number of buffers 
r19 [13 | smrsosum| 1 [binary [SMCAMXBF | Maximum number of buffers 


+20 SMFSOSWT binary SMF Options 
Bit When Set Indicates 

SMCAIPLR 0 PROMPT(ALL) 
SMCALIST 1 PROMPT(LIST) 
SMCAIPLR 2 PROMPT(IPLR) 
SMCAIPLR 3 PROMPT(NONE) 
SMCATDS 4 REC(PERM) 
SMCATDS 5 REC(ALL) 
SMCALDS 6 LISTDSN 
SMCALDS 7 NOLISTDSN 


(+21 | 15 |smrsonv7| 3 | | Reseed 
/+24 | 18 |smFooreL| 4 |escDic|cvTRELNO | _Operatingsystem release number 
(+28 | ic _|smrgouT | 4 [binary |SMCAITME | Timeof!PL 


res2 [20 [swrooiot | 4 [owcked [SMCaIOTE | aot iP SSCS 


SMF Data Set Section: There is a data set section for every SMF recording data set. The first data set is the 
active data set at IPL or SET SMF time. 


SMFSODSN EBCDIC | RDSDSNAM SMF data set name 








Subsystem Recording Section (Subtypes 5, 9, or 15): There are entries for the SYS, plus an entry for each additional subsystem 
subsystem specified in the SUBSYS keyword in SMFPRMxx. 


SMFSOWKN EBCDIC | SSTNAME Name of subsystem 


SMFSODTL binary SSTF LAGS DETAIL recording indicator 
Bit Meaning When Set 
0 Detail recording on 
1-7. Reserved 


1 For subtypes 5, 9, and 13, this field pointed to by SMFSODOF. 
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[ores [ome Yin [Former [Sere [Damn 


pat Recording Section (Subtypes 5, 9, or 15): (continued) 
SMF90RV9 Reserved 
SMF9O0SVL binary SSTINTVL Length of interval, in TOD clock format, between check 
point SMF records 


+16 SMFS90SYS SSTRCDON Bit Representation of SMF record types 
Bit O corresponds to record type O 
SMF9OEXN ; EBCDIC |EXITNAME 


Bit 255 corresponds to record type 255. If the bit is on 
(1), the record is enabled for recording. If the bit is 
off (0), the record is not enabled for recording. 
Switch SMF/Halt EOD Section aa 6 or 7): 
SMF90SWO EBCDIC | RDSNAME Old recording data set name 
ie tamer” EBCDIC | RDSNAME New recording data set name 
+20 | 14 | smFgoiT | 4 | binary |SMCAITME IPL time 
)+24 | 18 SMF9O0DT | 4 | packed | SMCAIDTE IPL date 


IPL ate Data Section a 8): 
SMFSO0DTM EBCDIC | Operator Response System down time in the form hh-mm-ss or ‘u’ 


reeuco "oC EBCDIC | Operator Response Reason for the IPL or ‘u’ 
+73 | 49 | SMF9S0OPR 20° | EBCDIC | Operator Response Operators name or ‘u’ 
SMF9OITM | 4 | binary |SMCAITME Time, in hundredths of seconds, of IPL 


+97 SMPSODTT packed |SMCAIDTE Date, in the form OOY YDDDF, where F is the sign, 
of IPL 
SET DATE/TOD Section (Subtypes 1 or 2): 
SMFS0OTM 4 packed | Time Macro Time before command was issued 


cae SMFSO0ODT | 4 [binary [Time Macro Old date before command was issued 


SET IPS Section (Subtype 4): 
SMF9OT IP binary Store Clock Set IPS time 


SMFSOIPO WMSTID Old IPS name 
IEAIPS — a the skeleton IPS. 


SETDMN Section (Subtype 3): 
. SMF90DDT 8 oti SETDTOC Time of change 


SMFSODFG binary SETDFLGS Domain flags 
Value Meaning 
X ‘80’ Minimum MPL changed 
X ‘40’ Maximum MPL changed 
X ‘20’ Weight changed 
X ‘10’ AOBJ changed 
X ‘08’ DOBJ changed 
X ‘04’ FWKL changed 


LA_|smroonmi | 2 | binary [SETOMIN New minimum MPL value 


"¢ a SWITCH operator command attempts to switch recording to a data set that is not empty, a data 
lost condition exists and the new data set name in the subtype 6 record is left blank. 


In subtype 7 records, the old and new data set names are blank. 















Names of the active exits for this subsystem. Each 
sequentially listed exit name is 8-characters long. Up to 
15 exits can be specified. If less than 15 exits are 
specified, the remaining portion of the list is filled 
with binary zeros. 
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Ss 


Tore [none [owe] ome | seme me 


SETDMN Section (Subtype 3): (continued) 





SMF9ONMA 2 binary SETDMAX New maximum MPL value! 


| | SMF9ONWT | 2 | binary | SETDWT New weight value! 
10 | SMF9ONAO SETDAOB New AOBJ value! 
+18 SMF9ONDO SETDDOB New DOB4J value! 


SMF9OWKL SETDFWK New FWKL value! 


NO 


binary SMCIATME 
SMCAIDTE 


EBCDIC | WMSTID IPS parmlib member used. 
IEAIPS—— — designates the skeleton IPS 


Time of IPL 





+16 SMF90OPT EBCDIC | RMPTOPTN OPT parmlib member used. 
IEAOPT -— — indicates no OPT 
SMFS9OICS EBCDIC ICSCNAME IEAICSxx parmlib member used. 
IEAICS** indicates no installation control specification. 













Store Clock 


Time of OPT change 


8 
i SMF90OPO Lj EBCDIC | RMPTOPTN Old OPT parmlib member, IEAOPT -- — indicates 
no OPT 


New OPT parmlib member 


SMF9OOPN EBCDIC | MBSUFFIX 


binary Store Clock Time of change 


8 
+8 SMF90ICO EBCDIC | ICSCNAME Old parmlib member, IEAICS** indicates no installation 
control specification 
ie 5 SMF9OICN | EBCDIC | MBSUFFIX New parmlib member 





binary Store Clock 


SMF9OMPO EBCDIC | SMFSFX 


8 


Time and date of change 


Name of old parmlib member or blanks if there is 
old MPFLSTxx parmlib member 


Name of new parmlib member 


Name of old parmlib member for color 


Store Clock 


binary 


8 
= 





Time of date and change 


Name of old parmlib member 


Name of new parmlib member 


— 


If the version number in SMF9ORVN equals X‘02’, the length of this field equals 2; otherwise, the length equals 1. 


Ce ead 
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Record Type 100 (64) — Data Base 2 Statistics ) 


Record type 100 is written by DATABASE 2 (DB2) to record transaction data 
collected at event monitoring points. For more information about record type 100, 
see IBM DATABASE 2 System Planning and Administration Guide (SC26-4085). 
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Record Type 101 (65) — Data Base 2 Accounting 
Record type 101 is written by DATABASE 2 (DB2) to account for resources 


during a transaction. For more information about record type 101, see JBM 
DATABASE 2 System Planning and Administration Guide (SC26-4085). 


Record Type 102 (66) — Data Base 2 Performance 


Record type 102 is written by DB2 to record performance information. For 
more information about the type 102 record refer to JBM DATABASE 2 
System Planning and Administration Guide (SC26-4085). 
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6-229 


Record Type 110 (6E) — CICS/VS Statistics y 


Record type 110 is written by CICS/VS to record transaction data collected at 
event monitoring points. For more information about the type 110 record, refer to 
| CICS/OS/VS Version I Release 7 Customization Guide, SC33-0239. 
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Chapter 7: Field-to-Record Cross-Reference 


This appendix lists all of the fields in the SMF records in alphabetical order and 
identifies the record type containing each field. It also gives the displacement of 
the field within the record. 


Some records have sections of fields that are generated only when specific events 
occur, such as when IPL is completed or when a device is varied online or offline. 
The following abbreviations appear under the “offset” column to indicate the section 
of the record where the field is found: 


ACT 
CHAN 
CHND 
CPU 
CPUD 
CRYP 
DCB 
DEV 
DEVD 
DSC 
EXT 
GENK 
IDAT 
ISAM 
KG 
MSS 
PERF 
PRNT 
REL 
RETK 
STAT 
STOR 
TAPD 
TAPU 
UCB 
VARY 
VOL 


Accounting section 

Channel section 

Channel data section 

CPU section 

CPU data section 

Cryptography initialization relocate section (5740-XY5, -XY6) 
DCB/DEB DASD extension entry 

Device entry 

Device data section 

Data set characteristics section 

Extent entry 

GENKEY relocate section (5740-XY5, -XY6) 
Installation data relocate section (5740-XY5, -XY6) 
ISAM extension section 

Key generator relocate section (S740-XY5, -XY6) 
MSS IPL configuration section 

Performance group period data section 

3800 Printing Subsystem section 

Relocate section 

RETKEY relocate section (5740-XY5, -XY6) 
Statistics section 

Storage section 

DCB/DEB tape extension entry 

UCB tape extension entry 

UCB section 

VARY ONLINE,S and VARY OFFLINES section 
Volume entry 


For MVS/System Product, the fields are not abbreviated and are listed as they 
appear in the record. 
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Record Offset ) 
Field Description Type Dec. Hex. 


Accepting VIO pages 75 Page/Swap data set data section 
79 PGSP data set section 





Access-method interfaces option codes 14 250 FA 
15 250 FA 
Accounting fields, job 5 121 79 
20 65 41 
26** 276 114 
30 Accounting section 
35 121 79 
Accounting fields, step 4 ACT 
30 Accounting section 
34 ACT 
Accounting number, networking 26* Network section 


57** Network section 
57* Network section 


Accounting number, programmer's 26* 104 68 
Address, CPU 22 CPU 
22 CHAN 
Address, line adapter 48* 72 48 
4s** 80 50 
Address, VT OC 19 40 28 
Address of lowest page in real 22 STOR 
contiguous storage 
Address space dispatching priority 4 57 39 
30 Processor section 
34 57 39 
Address space identifier 79 ARD/ARDJ section 


79 ASD/ASDJ section 
79 SENQR section 


Address space swap sequences 4 REL 
34 REL 
Allocation, device start time 4 90 5A 


30 Identification section 
32 Identification section 


34 90 5A 
Allocation status indicator 14 67 43 
15 69 43 
25** 42 2A 
Alternate tracks, number of unused 19 50 32 
AOBJ value 90 SETDMN section 
ASCB ready queue length 79 SRCS section 
Attentions on ending status of 50 40 28 (5735-RC2) 
READ channel programs 
Attentions received 50 36 24 (5735-RC2) 


*These records are for JES2. 
**These records are for JESS. | 
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L 


ELIE TE I OTL ES EI SAE ST REALS, 
*These records are for JES2. * 
**These records are for JES3, 


Vexespt 2, 3 


Field Description 


Record Offset 
Type Dec. Hex. 





Average cycie time 

Average number of ready users 
Average number of slots used 
Beginning cylinder and track 


Bind failure or unbind reason code 


Block count for each volume 


Block size 


Blocksize - Sort records 
maximum input 
output 
BUF parameter 
Buffer, date record was moved to 
Buffer, number of bytes in SMF 
Buffer, size of time-sharing 
Buffer, time record was moved to 


Buffers, number allowed per terminal 
before LWAIT 


Buffers, number allowed per terminal 
before OWAIT 


Buffers, number reserved on free queue 
Buffers, number of time-sharing 
Buffers, number written 
Burster-Trimmer-Stacker 

Bus-out checks, number of 


Byte count, printed 
actual 
estimated 


Bytes, number sorted 
Bytes read, * 4096 
Bytes written, * 4096 


‘Cards, input, number of 


Cards, punched, number of 
Cards generated to spool, number of 


Card-imege records in DD DATA and 
DD* data sets read for step/job 


Catalog name 


79 CHANNEL section 
79 DDMN section 


75 Page/Swap data set section 


64 EXT 

39 116 74 
14 TAPD 

15 TAPD 

21 Gd 2C 
64 DSC 


16 Data section 
16 Data section 


0 22 16 
ALL’ 10 A 
0 22 16 
31-20 14 
ALL’ 6 6 

31-26 1A 
31-24 1B 
31.32 20 
31 18 12 
23 Statistics section 

6 PRNT 

48** 66 42 


26* Print section 
26* Print section 


16 Data section 
21 56 38 
21 59 3B 


26* 208 DO 
26°* 248 F8 


26 120 78 
26° 216 D8 


26°* 256 100 
4 51 33 
5 51 33 
30 1/0 activity section 
61 75 4B 
62 46 2E 
63 48 30 
64 44 2C 
65 75 48 
66 76 4B 
67 GL, 2C 
68 42 2A 
69 56 38 
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Record Offset ) 
Field Description Type Dec. Hex. 


Catalog record size 63 44 2C 
63 46 2E 
67 132 84 
Catalog record 61 208 DO 


65 208 DO 
66 208 DO 


Catalog records 63 136 88 

67 134 86 
CCHH, beginning 64 EXT 
CCHH, ending 64 EXT 
Channel path id 4 DEV 

8 DEV 

9 DEV 

10 DEV 

11 DEV 

14 UCB 

15 UCB 

19 64 40 

21 26 1A 

22 CHAN 

30 EXCP section 

34 DEV 

40 DEV 

64 EXT 


69 42 2A 





Channel busy number of samples 73 Channel path data section 

Channel identifier 79 CHANNEL section 

Channel model number 22 CHAN 

Channel path samples, number of 78 Subtype 1 1/O queuing data section 

Channel path section identification 22 CHAN 

Channel path status 78 Subtype 1 1/O queuing configuration data section 


Subtype 3 1/O queuing configuraiton data section 


Channel path busy, number of samples 73 Channel path data section 


Channel path busy, percent 79 Subtype 14 1/O queuing section 
Character arrangement table names 6 PRNT 
Class, job 5 75 4B 
26 89 59 
Class, associated with PGN 72 62 3E 
Class, message 26 88 58 
Class, service 39 90 5A 
Class, SYSOUT 6 42 2A 
Cleaner actions, number of 21 41 29 
Collection period begin time stamp 39 2 2 
Collection period end time stamp 39 10 A 
Configuration indicator 70 CPU section 
Contention index 79 DDMWN section 
Command rejects, number of 48** 64 40 





*These records are for JES2. 
**These records are for JESS. 
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C 





*These records are for JES2. 
**These records are for JES3. 


Field Description 


Record Offset 
Type Dec. Hex. 





Common area page-ins 


Common area reclaims 


Completion code, JES2 
Completion code, JES3 


Completion code, job 


Completion code, step 


Completion code, transmission 
destination 


Completion code, transmission origin 
Component indicator 


Component or cluster name 


Configuration activity indicator 
Connect time’ total for this device 
Continuous wait time limit 

Control areas, number that were split 
Control interval size 

Control intervals, number of unused 


Control intervals, number that were 
split 


Conversion processor (CPU) 
identification 


Control unit busy delay 
Control units attached, number of 
Control unit (logical) identifier 


Control unit (logical) number 
Converter start time 
Converter start date 
Converter stop time 
Converter stop date 


Copies, number printed with overlay 
Copy groups 
Copy modification module name 


Count of READ channel programs 


4 EL 

30 Storage and paging section 
34 REL 

4 REL 

30 Storage and paging section 
34 REL 

45* 26 1A 

45** 25 19 

5 55 37 

30 Completion section 

35 55 37 

4 55 37 

30 Completion section 

34 55 37 


59 Transmission section 


59 Transmission section 


64 43 ZR 
62 96 60 
64 88 58 


70 CPU data section 
30 EXCP section 


0 18 12 
64 STAT 

64 DSC 

64 STAT 

64 STAT 


26* 224 EO 
26** 264 108 


74 Device data section 
78 Subtype 1 |/O queuing configuration data section 
78 Subtype 3 1/O queuing configuration data section 


74 Device data section 
79 Subtype 9 device data section 


26* 156 9C 
26** 196 C4 
26* 160 AQ 
26** 200 C8 
26* 164 A4 
26** 204 CC 
26* 168 A8 
26** 208 DO 
6 PRNT 

6 PRNT 

6 PRNT 

50 34 22 (5735-RC2) 


Chapter 7, Field-to-Record Cross-Reference 7-5 


7-6 


Field Description 


Record Offset 
Type Dec. Hex. 





Count of WRITE channel programs 
CPU identification 


CPU address 


CPU model number 


CPU resource factor coefficient 
CPU serial number 


CPU service 


CPU service definition coefficient 


CPU time 


CPU service coefficient 
CPU-Vector Facility indicator 
CPU wait time 


Cross memory address space indicator 
Cross netowrk session 
CSA size 


CSA usage 


Cryptographic Unit Support 
CKDS activity flags 
function code 
installation exit data 
number of variable relocate sections 
options 
return code 


Cylinder overflow areas that are full, 
number of 


Cylinders, number of unallocated 


System Management Facilities (SMF) 


50 30 1E ($734-RC2) 


70 8 8 

22 CPU 

22 CPU 

70 CPU control section 
72 17 11 

70 CPU data section 

4 REL 

5 REL 

30 Performance section 
34 REL 

35 REL 

72 Workload control section 
4 99 63 

4 ACT 

5 77 4D 

5 11-7 75 


30 Processor accounting section 
34 99 63 


34 ACT 
35 Ld 4D 
35 117 75 


79 DDMN section 

22 CPU section 

70 CPU data section 

719 106 6A 

3g IS 73 

78 Common virtual storage section 


78 Common virtual storage section 


82 (5 740-XY6) 


82 KG 

82 43 2B 
82 IDAT 

82 41 19 
82 CRYP 

82 44 30 
14 ISAM 

15 ISAM 

19 52 34 


69 48 30 








Cylinders in independent index, 14 ISAM 
prime data, and independent overflow 15 ISAM 
areas, number of 
Cylinders in largest continuous 69 52 34 
unallocated area, number of 
Cylinders in largest unallocated 19 56 38 
extent, number of 
DAE COMMAND TIME/DATE 90 Set DATE/TOD section 
DAE MEMBER OLD/NEW 90 Set DATE/TOD section 
DASD volume status indicator 14 UCB 
15 UCB 
Data checks to read text, number of 48* 60 3C 
48** 68 28 
Data format error indicators o** 92 5C 
Data overruns, number of 48** 69 45 
Data recording devices (DRDs) 22 MsS 


S *These records are for JES2. 


**These records are for JES3. 
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Record Offset 








Field Description Type Dec. Hex. 
Data set, accepting VIO pages 75 Page/Swap data set data sectior 

79 PGSP data set section 
Data set control indicator 6 66 42 
Data set indicator 14 42 2A 

14 55 37 

14 252 FC 

15 42 2A 

15 55 37 

15 252 FC 
Data set name 17 44 2C 

18 44 2C 

18 88 58 

79 PAGESP section 
Data set organization 14 244 F4 

15 244 F4 
Data set record count 24 SYSOUT selection criteria section 
Data set sequence count 14 TAPU 

15 TAPU 
Data set sequence number 14 TAPU 

15 TAPU 
Data set serial number 14 TAPD 

15 TAPD 


Data sets open on device, total number of 74 Device data section 
79 Subtype 9 device data section 


Data sets processed by writer, 6 56 38 — 
number of 
Data space extents, number of free 69 46 2E 
Date, deadline schedule 26** 172 AC 
Date, JES3 allocation 25** 80 50 
Date, JES3 device verification 25** 88 58 
Date, logoff 30 10 A 
30 10 A 
Date, logon 30 Identification section 
34 30 1E 
35 30 1E 
40 30 1E 
Date, logon enqueue 30 Identification section 
32 identification section 
35 62 3E 
Date *START SETUP command issued 25 64 40 
Date converter started 26* 160 AO 
26** 200 C8 
Date converter stopped 26* 168 A8 
26** 208 DO 
Date execution processor started 26* 176 BO 
26** 216 D8 
Date execution processor stopped 26* 184 B8 
26** 224 EO 
Date fetch processing ended 25** 56 38 





*These records are for JES2. Date all volume mount messages issued 25** 80 50 
**These records are for JES3. 
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Record Offset 
( Field Description Type Dec. Hex. 


Date initiator selected step/job 4 47 2F 
5 47 2F 
30 Identification section 
32 Identification section 





Date, IPL 90 Self-defining section 
Date job terminated 5 10 A 
30 10 A 
35 10 A 
Date offload data set was allocated 24 General section 
Date output processor started 26* 192 Co 
26** 232 E8 
Date output processor stopped 26* 200 C8 
26** 240 FO 
Date output service started 6: * 47 2F 
Date print/punch processor started 6* 47 2F 
Date reader recognized end of job 5 62 3E 
26* 152 98 


26** 192 co 
30 Identification section 


Date reader recognized the JOB card 4 30 1E 
5 30 1E 
6 30 1E 
10 30 1E 
14 30 1E 
15 30 1E 
17 30 1E 

w 18 30 1E 

20 30 1E 
25** 30 1E 
26 30 1E 
30 Identification section 
40 30 1E 
60 62 3E 
61 62 SE 
62 30 1E 
63 30 1E 
64 30 1E 
65 62 3E 
66 62 3E 
67 30 1 
68 30 1E 
69 30 1E 
78 Subtype 2 (virtual storage) private area data section 

Date record was moved to dump 2 10 A 

data set 3 10 A 

Date record was moved to SMF buffer ALL! 10 A 

Date recording was started when 7 24 18 

SMF data set became available 

Date RMF measurement interval 70-79 14 E 

started 

Date step terminated 4 10 A 
30 Identification section 

( *These records are for JES2. 34 10 A 
ea hece paccrdsaratoress. Date transaction queued 59 Transaction type section 


‘except 2, 3 
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Record Offset | 
Field Description Type Dec. Hex. 





DCBOFLG 21 42 2F 

DCB=OPTCD=J 6 PRNT 

DD DATA and DD* data set records 4 51 33 

read for step/job 5 51 33 
30 I/O activity section 

DD entry length 14 52 34 
15 52 34 

DD name 14 56 38 
15 56 38 


26° 136 88 
30 EXCP section 





64 DSC 
Deadline schedule date 26** 172 AC 
Deadline schedule time 26** 168 A8 
Deadline schedule type 26** 124 7C 
Deleted records, number of 64 STAT 
Density, tape 21 43 2B 
Dependent job net identification 26** 160 AO 
Detail recording indicator 90 Subsystem recording section 
Device active time 74 Device data section 
Device allocation requests, number of 14 54 36 

15 54 36 
Device busy 74 Device section 
Device busy delay 74 Device data section 
Device class 4 DEV 

5 73 49 

8 DEV 

9 DEV 

10 DEV 

11 DEV 

30 EXCP section 

34 DEV 

40 DEV 
Device class code 74 6 6 
Device connect time 74 Device data section 
Device disconnect time 74 Device data section 
Device indicator 14 55 37 

14 252 FG 

15 55 37 

15 252 FC 
Device name, logical input 26 96 60 
Device name, logical output 6 72 48 
Device name, transmitter 26* Network section 

57* 64 40 
Device number 4 Device section 


8 Device section 
9 Device section 
10 Device section 
11 Device section 





*These records are for JES2. 
**T hese records are for JES3. 
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*These records are for JES2. 


**These records are for JES3. 


Field Description 


Device pending time 
Device recording controls, MSF 


Device reserved samples, number of 


Device SSID 


Device type 


Devices, MSF data recording 


Devices requested during allocation, 
number of 


Device allocation start time 


Disk volumes, number of 
requests for 


Disk volumes mounted by MDS, 
number of 


Dispatch position/priority 
DOB4J value 


Domain number 


Drive number 
DSCBs, number of 
DSCBOs, number of 


Dump data set, date record was 
moved to 


E-Frames 


Dump data set, time record was 
moved to 


End-of-volume indicator 


Ending cylinder and track 


ENQ 
address space identifier of job that 
issued ENQ 
name of job that issued ENQ system 
system identifier of job that issued 
ENQ 


Record Offset 
Type Dec. Hex. 


14 UCB section 

15 UCB section 

19 64 40 

21 26 1A 

30 EXCP section 

34 Device section 

40 Device section 

64 EXT 

69 42 2A 

74 Device data section 

75 Page/Swap data set section 

79 Subtype 9 (DEV) device data section 
79 Subtype 11 (PGSP) data set section 


74 Device data section 
22 MSS 


74 Device data section 
79 Subtype 9 (DEV) device data section 


22 VAR 


74 Device control data section 
79 Subtype 11 (PGSP) data set section 


22 MSS 


14 54 36 
15 54 36 


4 90 5A 
30 Identification section 
34 90 5A 


25** 48 30 


25** 72 48 


79 Subtype 1 (ASD/ASD4J) data section 
90 SETDMWN section 


79 ASRM/ASRM4J section 
90 SETDMWN section 


19 66 42 
19 46 2E 
19 48 30 


2 10 A 
3 10 A 
22 Extended storage section 
2 6 6 
3 6 6 


14 253 FD 
15 253 FD 


64 EXT 


79 Subtype 6 (SENQR) data section 


79 (SENOR) data section 
79 (SENQR) data section 
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Record Offset 
Field Description Type Dec. Hex. 





Enqueue status indicator 77 58 3A 
Entries to the 1/O SLIH, number of 70 16 10 
Entry name 60 120 78 

61 120 78 


63 92 5C 
65 120 78 
66 120 78 
67 88 58 
68 130 82 


Entry type indicator 60 119 77 
61 119 77 
63 42 2A 
63 43 2B 
65 119 77 
66 119 77 
67 88 58 
68 86 56 
68 139 82 


Equipment checks, number of 48** 67 43 
Erase gaps, number of 21 39 2/7 
Errors, line 48* 69 45 
48** 56 38 
Errors, number of temporary 53* Identification section 
ERV resource manager coefficient 72 20 14 
Event records 37 Event section 
Event type 37 Event section wi 
Exception responses, number of 53* Identification section 
EXCP count 4 DEV 
14 UCB 
15 UCB 
30 EXCP section 
34 DEV 
40 DEV 
48 52 34 
64 STAT 
79 ARD/ARD4J section 
EXCP count for step 79 ARD/ARDJ section 
Execution processor (CPU) 26* 228 E4 
identification 26** 268 10C 
Execution processor start time and 26* 172 AC 
date 26** 212 D4 
Execution processor stop time and 26* 180 B4 
date 26** 220 AC 
Execution time, estimated 26 112 70 
Exits, names of active 90 Subsystem recording section 





*These records are for JES2. 
**T hese records are for JES3. 
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*These records are for JES2. 


**These records are for JES3. 


Field Description 


Exposures for a multiple exposure 


device, number of 
Extended storage frames 


Extents, number of 


Extents, number of unallocated 

Extents in independent index, prime 
data, and independent overflow 
areas, number of 


Extents released by DADSM routine, 
number of 


FCB image indentification 


Feet of document printed, number of 
Fetch processing end date 
Fetch processing end time 


Fixed frames below 16 megabytes, 
average number of 


Fixed frames below 16 megabytes, 
maximum number of 


Fixed frames below 16 megabytes, 
minimum number of 


Fonts, number loaded 
Fonts, number used 


Form number 


FORMDEFBFS, number used 
Forms Overlay name 


Frames, 
Extended storage 
Min/max/avg CSA 


Min/max/avg LSQA 


Min/max/avg LPA 


Min/max/avg in private 


address space 


Min/max/avg SQA 


Min/max/avg total 


Record Offset 
Type Dec. Hex. 


74 Device control data section 


22 Extended storage section 


14 UCB 

15 UCB 

64 STAT 

19 60 3C 
14 ISAM 

19 ISAM 

14 DCB 

15 DCB 

6 80 50 


24 SYSOUT selection criteria section 


6* 64 40 
25** 56 38 
26°". "52 34 


71 344 158 
71 340 154 
71 336 150 


6* 40 28 
6* 36 24 


6 57 39 

6* JES2 routing section 
26* 124 7C 
26* Print section 


6* 72 48 
6 PRNT 


22 see Extended storage section 


71 204 CC 
71 208 DO 
71 212 D4 
71 324 144 
71 328 148 
71 332 14C 
71 312 138 
71 316 13C 
71 320 140 
71 216 D8 
71 220 DC 
71 224 EO 
71 192 co 
71 196 C4 
71 200 C8 
71 228 E4 
71 232 E8 
71 236 EC 
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*These records are for JES2. 
**T hese records are for JES3. 


Field Description 


number above or below the 
16-megabyte line 

Unused in nucleus 
Min/max/avg unused 


Function active time 

Function pending time 
Functional indicator 

FWKL value 

GENKEY flags 

GENKEY key name 

GETMAIN limit 

Highest used relative byte address 


IEAICSxx member used 
old /new 


IEAIPSxx member 
{\EAOPTxx member 


|/O processing method indicator 


1/O service 


1/O status 
|OP data status 
Impulse Hit Count 


Index levels, number of 


Initial selection attempts, total 
number of 


Initialization deck origin 


Initiator select data for step/job 


Initiator select time for step/job 


Initiator Vector Facility affinity time 
Initiator Vector Facility usage time 


Input cards for job, number of 
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Record Offset 
Type Dec. Hex. 


71 Paging data section 


71 140 8C 
71 84 54 
71 88 58 
rs 92 5C 


79 Subtype 9 (DEV) device data section 

79 Subtype 9 (DEV) device data section 

40 43 2B 

90 SETDMWN section 

82 GENK (5740-XY5, -XY6) 

82 GENK 

78 Subtype 2 (virtual storage) area data section 
64 134 86 


72 Workload control section 

72 Workload control section 

79 Subtype 8 (TRX) data section 
90 IPL SRM section 

90 SET ICS section 


79 Subtype 8 (TRX) data section 


72 Workload control section 
72 96 60 


14 253 FD 
15 253 FD 


4 REL 

5 REL 

30 Performance section 
34 REL 

35 REL 

6 55 37 


78 Subtype 3 IOP initiative queue section 


37 10 A 
14 ISAM 
15 ISAM 
64 STAT 


78 Subtype 1 |/O queuing data section 


43** 29 1D 
4 47 2F 
5 47 2F 


30 Identification section 
32 Identification section 


4 43 2B 
5 43 2B 
30 Identification section 
32 Identification section 


34 43 2B 
30 32 20 
30 24 18 


26* 208 DO 
26** 248 F8 





c 


*These records are for JES2. 


**These records are for JES3. 


Field Definition 


Record Offset 


Type Dec. Hex. 





Input class for job 


Input processor (CPU) identification 


Input route code 

Input/output (see |/O) 

Inserted records, number of 
Intelligience controller name 
Interventions required, number of 
1/O service definition coefficient 
1OC resource factor coefficient 
IOC service definition coefficient 


IPL reason 
IPS name 


JES selection priority 


JES job number 


JES2 completion code 


JES2 identification 


JES2 job selection priority 


JES2 logical input device name 
JES2 logical output device name 


JES2 output selection priority 


JES2 start options 
JES2 termination indicator 


JES2-assigned job number 


JES3 allocation completion date 
JES3 allocation completion time 
JES3 completion code 


JES3 device verification date 


5 75 48 
30 Identification section 


26* 220 DC 
26** 260 104 


26* 94 oe 


64 STAT 


50 18 12 ($735-RC2) 


48** 65 41 


79 Subtype 10 (DDMN) data section 
72 Workload contro! section 


72 Workload control section 


90 IPL PROMPT section 
90 IPS section 


5 57 39 
26 90 5A 
26 91 5B 


30 Identification section 
32 Identification section 
35 59 3B 


6 68 44 
26 56 38 
30 Identification section 
32 Identification section 


45 26 1A 


6* 62 3E 
24 18 12 
26* 46 2E 
43* 18 12 
45* 18 12 
47* 18 12 
48* 18 12 
49* 18 12 


26* 90 5A 
26* 91 5B 


26* 96 60 
6* 72 48 


26* 92 5C 
26* 93 5D 


43* 27 1B 
45* 24 18 


6* 68 44 
26* 56 38 
30 Identification section 
32 Identification section 


25** 80 50 
20° 76 4c 
45** 25 19 
25** 88 58 
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7-15 


Record Offset 
Field Description Type Dec. Hex. 





JES3 device verification time 25** 84 54 
JES3 identification 6* 60 3C 
26** 46 2C 
43** 18 12 
45** 18 12 
47** 18 12 
48** 18 12 
49** 19 12 
JES3 initialization deck origin 43** 30 1E 
location 
JES3 initialization deck origin type 43** 29 1D 
JES3 job selection priority 26** 90 5A 
26** 91 5B 
JES3 logical input device group name 26** 128 80 
JES3 logical input device name 26** 96 60 
JES3 logical output device group name 26** 96 60 
JES3 logical output device name 26** 72 48 
JES3 procedure name 43** 38 26 
JES3 start options 43** 26 1A 
JES3 termination indicator 45** 24 18 
JES3-assigned job number 6** 68 44 
26** 56 38 
JFCB 14 68 44 
15 68 44 
FJCB TTR address 14 64 40 
15 64 40 
Job . 
origin 57 ** 106 6A 
Job accounting fields 5 121 79 


26 Network section 
30 Accounting section 
35 121 79 


Job class 5 75 4B 
30 Identification section 
24 Job selection criteria section 


26 89 59 
Job class name 26°" 176 BO 
Job completion code 5 55 37 
30 Completion section 
35 55 37 
Job CPU time 5 77 4D 
5 117 75 
30 Processor accounting 
35 77 4D 
35 117 75 
Job identification 26 60 3C 
current 24 General section 
26 60 BC 
57** 24 18 
24 General section 
original 57** 24 18 
Job information indicator 26 54 36 





*These records are for JES2. 


7-16 System Management Facilities (SMF) 


c 


*These records are for JES2. 


**These records are for JES3. 


Field Description 


Job log identification 


Job name 


Job Number 


current 


Original 


Record Offset 


Type Dec. Hex. 


4 18 12 
5 18 12 
6 18 12 
10 18 12 
14 18 12 
ses) 18 12 
i, 18 12 


18 18 12 
20 18 12 
24 General section 


25** 18 1:2 
26 18 12 
30 Identification section 
40 18 12 
60 50 33 
61 50 33 
62 18 12 
63 18 12 
64 18 12 
65 50 33 
66 50 33 
67 18 12 
68 18 12 
69 18 12 


78 Subtype 2 (virtual storage) private area data section 


4 18 12 
5 18 12 
6 18 12 
10 18 12 
14 18 12 
15 18 12 
17 18 12 


18 18 12 
20 18 12 
25** 18 12 
26 18 12 
30 Identification section 
32 Identification section 
34 18 12 
35 18 12 
40 18 12 
57** 34 22 
60 50 32 
61 50 32 
62 18 12 
63 18 12 
64 18 12 
65 50 32 
66 50 32 
67 18 12 
68 18 12 
69 18 12 


78 Subtype 2 (virtual storage) private area data section 


82 24 18 


6 68 44 
26 56 38 
30 Identification section 
32 Identification section 


57** 42 2A 
57** 46 2E 


Chapter 7. Field-to-Record Cross-Reference 


*These records are for JES2. 
**T hese records are for JES3. 


Field Description 


Job print copy count 
Job print route code 


Job priority 


Job selection priority 


Job performance group number 


Job punch route code 


Job service 


Job/step Vector Facility affinity time 
Job/step Vector Facility usage time 


Job termination date 


Job termination indicator 


Job termination time 


Job transaction active time 


Job transaction residency time 


Job transmitter 
Start/stop time 
Start/stop date 


Job type indicator 
Juv wait time limit 


JWT parameter 


Key, storage protect 


Key length 


Length of accounting and availability 
data sections 


Length of DD entry 


Length of LPDA-2 section 
Length of LAN section 


7-18 System Management Facilities (SMF) 


Record Offset 
Type Dec. Hex. 


26* 128 80 
26* 132 84 


5 57 39 
30 Processor accounting section 
35 So? 39 


26 90 5A 


26 91 58 
4 REL 
5 92 5C 


30 Identification section 
32 Identification section 
34 REL 

35 92 5C 


26* 134 86 


5 80 50 
30 Performance section 
35 80 50 


30 28 1C 
30 20 14 


5 10 A 
30 10 A 
35 10 A 


5 66 42 
30 Completion section 
35 66 42 


5 6 6 
30 6 6 
35 6 6 
5 84 54 


30 Performance section 
35 84 54 


6 
30 Performance section 
35 68 44 


26* Network section 
26* Network section 


o7** 28 2C 


0 18 12 
0 18 12 
90 SMF command section 
4 86 56 
5 76 4C 


30 Storage and paging section 
34 86 56 
35 76 4C 


64 DSC 

39 36 24 
14 52 34 
15 52 34 
37 66 42 
37 74 4A 


c 


*These records are for JES2. 


**These records are for JES3. 


Field Description 


Length of measurable interval 


Length of product section 
Length of securing header 


Limit, continuous wait time 


Line adapter number 


Line errors 


Line name 


Line quality 
Lines, output, number of 


Lines, terminal input, number of 


Lines, terminal output, number of 


Lines generated to spool, number of 


Lines, password 


Lines per page, number of 
Lines, VTAM requests processed 


Link pack area page-ins 


Link pack area reclaims 


Link Segment Level 

Local Modem Report 

Local page data set slots 
min/max/avg allocated to 
non-V1IO private area 
min/max/avg allocated to 
VIO private area 


min/max/avg unallocated 


min/max/avg unusable 


Record Offset 


Type Dec. Hex. 


23 System section 
90 Subsystem recording section 


39 44 
82 18 12 
0 18 12 


90 SMF command section 


48* 72 48 
48** 80 50 


48* 68 44 
48*" 56 38 


47 36 24 
48 36 24 
49 36 24 
52* Identification section 
53* Identification section 
55* 34 22 
56* 34 22 
58* Identification section 


37 6 6 
26 116 74 
34 51 33 
30 1/O activity section 
35 51 33 


34 47 2F 
30 1/O activity section 
35 47 2F 


26* 212 D4 
26** 252 FC 


52* Identification section 
53* Identification section 


26* 130 82 


53* Identification section 


4 REL 

30 Storage and paging section 
34 REL 

4 REL 

30 Storage and paging section 
34 REL 

37 3 3 
37 8 8 
71 204 CC 
71 208 DO 
71 212 D4 
71 192 CO 
71 196 C4 
71 200 C8 
71 288 120 
71 180 B4 
71 184 B8 
71 188 BC 
71 216 D8 
71 220 DC 
71 224 EO 
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Field Description 

Logical record size, maximum 
Logical record, TP 

Logical records, number written 


Logical records in overflow and prime 
data areas, number of 
Logoff date 


Logoff time 


Logon date 


Logon enqueue date 


Logon enqueue time 


Record Offset 
Type Dec. Hex. 


64 DSC 

57* 100 64 
6 51 33 
14 ISAM 

15 ISAM 

30 10 A 
35 10 A 
30 6 6 
35 6 6 
30 Identification section 
34 30 1E 
35 30 1E 
40 30 1E 


30 Identification section 
35 62 3E 


30 Identification section 


35 58 3A 


30 Identification section 
35 57 39 


Logon priority 


Logon time 30 Identification section 
34 26 1A 
35 26 1A 
40 26 1A 
Lost dates, number of 48** 70 46 
Lowest page address in real 22 STOR ws 
continuous storage 
LPA page-ins 4 REL 
30 Storage section 
34 REL 
LPA reclaims 4 REL 
30 Storage section 
34 REL 


LPA size 78 Common virtual storage section 


LSQA storage usage 78 Private virtual storage section 


LU name 47** 36 24 
48** 36 24 
48** 36 24 


MAC address, downstream 37 36 24 
MAC address, upstream 3? 30 1E 
Macro instruction and option types 14 247 F7 
14 ISAM 
15 247 F7 
15 ISAM 
Main storage service 4 REL 
5 REL 
30 Performance section 
34 REL 
395 REL 
Main storage service definition 72 34 22 
coefficient 


MAXDORM value 90 SMF command section 





Maximum input block size 16 Data section 


*These records are for JES2. 
**These records are for JES3. 


7-20 System Management Facilities (SMF) 


*These records are for JES2. 
**These records are for JESS. 


Field Description 


Maximum logical record size 


Measurement interval, RMF 
date started 
duration 


Message class 


Message text 


Model number, channel 
Model number, CPU 


Modem address 
Modem Model 
Modem Sense Byte 
Modem Speed 
Modem Type 

Module identification 


MPL value 


MSF data recording devices 
MSF device recording controls 
MSF indicator 

MSO service coefficient 

MSS volume requests 


MVS/BDT, 
destination file name 
job number 
node name 
origin file node 
PDS member name of 
destination file 
transaction queuing node 
transaction source node 
transaction source processor name 


MVS software level 


Name of catalog 


Name of component or cluster 


Record Offset 
Type Dec. Hex. 


64 DSC 


70-79 14 E 
70-79 18 12 


26 88 58 


47 54 36 
49 54 36 


22 CHAN 
22 CPU 


37 Modem section 


37 4 0 
37 2 2 
37 16 10 
37 0 0 


19 66 42 


90 SETDMWN section 
79 DDMN section 


22 MSS 
22 MSS 
22 MSS 


79 DDMN section 
25** 92 5C 


59 Transaction type section 

59 Transaction identifier section 
59 Product section 

59 Transaction type section 


59 Transaction type section 

59 Transaction identifier section 
59 Transaction identifier section 
59 Transaction identifier section 


70 40 28 
71 40 28 
72 40 28 
73 40 28 
74 40 28 
75 40 28 
76 40 28 
77 40 28 
78 40 28 
79 40 28 


61 75 4B 
62 46 2E 
63 48 30 
64 44 2C 
65 15 48 
66 75 48 
67 44 2C 
68 42 2A 
69 66 34 


62 96 60 
64 88 58 


Chapter 7. Field-to-Record Cross-Reference 


7-21 


Record Offset : 
Field Description Type Dec. Hex, 


Name of data set 17 44 2C 
18 44 2G 
18 88 58 





Name of device, logical 6 72 48 
26 96 60 
Name of entry 60 120 78 
61 120 78 


63 92 5C 
65 120 78 
66 120 78 
67 88 58 
68 86 56 
68 130 82 


Name of exits 90 Subsystem recording section 
Name of IPS 72 56 38 
Name of job 4 18 12 

5 18 12 

6 18 12 


10 18 12 
14 18 12 
15 18 12 
17 18 12 
18 18 12 
20 18 12 
25** 18 12 


26 18 12 
30 Identification section ) 


32 Identification section 
34 18 12 

35 18 12 

40 18 12 

59 Transaction data section 
60 50 32 

61 50 32 

62 18 12 

63 18 12 

64 18 2 

65 50 32 

66 50 12 

67 18 12 

68 18 12 

69 18 12 

78 Private virtual storage section 
82 24 18 


Name of job class 26** 176 80 


Name of line 47 36 24 
48 36 24 
49 36 24 





**These records are for JES3. 


7-22 System Management Facilities (SMF) 


( Record Offset 
Field Description Type Dec. Hex. 





Name of LU 47** 36 24 
4s** 36 24 
49** 36 24 
Name of program 4 58 3A 
30 Identification section 
34 58 3A 
78 Private virtual storage section 
Name of programmer 5 97 61 
20 | 26 
26 68 44 
59 Transaction data section 
Name of remote device 47 28 1c 
48 28 1C 
49 28 1C 
Name of step 4 66 42 
30 Identification section 
34 66 42 
78 Private virtual storage section 
82 32 20 
Name of system, if NJP 26** 96 60 


26°* 144 90 
26** 152 98 


Name of VSAM Volume data set 60 7§ 48 
Name of work station 47** 28 1C 
4s** 28 1C 
49** 28 1C 
~ Name of work station 47** 28 1C 
4s** 28 1C 
49*°* 28 1C 
NCP entered slowdown, number 50 58 3A 
of times 
Negative acknowledgements to 48* 56 38 
write text, number of 4s** 62 3E 
Negative response count, RECEIVE 4s** 62 3E 
Negative response count, SEND 48** 60 3C 
Network accounting number 26° Network section 
57** 74 4A 
New catalog record 61 208 DO 


63 136 88 
65 208 DO 
66 208 DO 
67 134 86 


New catalog record size 63 44 2C 
67 132 84 
New data set name 18 88 58 


= ———————————— a] 
*These records are for JES2 only. 
**These records are for JES3 only. 
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New entry name 66 164 Aa } 
68 130 82 


New VSAM Volume Record 60 208 DO 
Node name 26°° Network section 
55° 24 18 
56° 24 18 
58* 24 18 
59 Product section 
executing §7° 48 30 
§7*°* 122 7A 
destination 57°* 138 8A 
next 57° 40 28 
original 24 General section 
§7° 40 28 
Noise blocks, number of 21 38 26 
Non-VIiO, non-swep page-ins 4 REL 
30 Storage and paging section 
34 REL 











*These records are for JES2 only. 
**These records are for JES3 only. 


7-24 System Management Facilities (SMF) 


c 


*These records are for JES2. 


**T hese records are for JES3 


Field Description 


Non-V1IO, non-swap page-outs 


Non-V1IO page reclaims 


NPA, 
Event records 
Event type 
Modem address 
Release level 
Resource name, failure 
Resource type, failure 


Nucleus size 


Number of accounting and availability 
data sections 


Number of address space swap 
sequences 


Number of address space swap 
sequences 


Number of blocks per volume 


Number of buffers allowed per 
terminal before LWAIT 


Number of buffers allowed per 
terminal before OWAIT 


Number of buffers reserved on 
free queue 


Number of buffers 
written 
minimum/maximum 


Number of bus-out checks 
Number of bytes in real storage 
Number of bytes in SMF buffer 
Number of bytes in virtual storage 
Number of bytes sorted 


Number of cards, input 


Number of cards, output punched 


Number of cards generated to spool! 


Number of card-image records in DD 
DATA and DD* data sets read for 
step/job 


Number of cleaner actions 
Number of command rejects 


Number of copies printed 


Record Offset 


Type Dec. Hex. 


4 REL 
30 Storage and paging section 


30 Storage and paging section 


37 Event section 
37 Event section 
37 Event section 
37 Event section 
37 Event section 
37 Event section 


78 Common virtual storage section 


39 38 26 

4 REL 

30 Storage and paging section 
34 REL 

79 SRCS Data section 

4 REL 

30 Storage and paging section 
34 REL 

79 SRCS Data section 

14 TAPD 

15 TAPD 

31 26 1A 

31 24 18 

31 32 20 


23 Statistics section 
90 SMF command section 


48** 66 42 


0 31 1F 
0 22 16 
0 26 1A 


16 Data section 


26* 208 DO 
26** 248 F8 


26 120 78 


26* 216 D8 
26** 256 100 


4 51 33 

5 51 33 
30 1/O activity section 
21 41 29 
48** 64 40 

6 PRNT 


Chapter 7. Field-to-Record Cross-Reference 7-25 


*These records are for JES2. 


**These records are for JES3. 


Field Description 


Number of control bytes sent from 
primary to secondary 


Number of control bytes sent from 
secondary to primary 


Number of control PIUs sent from 
primary to secondary 


Number of control PIUs sent from 
secondary to primary 


Number of cylinders in independent 
index, prime data, and independent 
overflow areas 


Number of cylinders in largest 
continuous unallocated area 


Number of cylinders in largest 
unallocated extent 


Number of data checks to read text 


Number of data overruns 


Number of data sets 
open 
requested 


Number of data set sequences 


Number of data sets processed by 
writer 


Number of devices requested during 
allocation 


Number of disk volumes requested 


Number of disk volumes mounted 
by MDS 


Number of DSCBs 
Number of DSCBQOs 


Number of E-frames 
available 
installed 


Number of enqueued requests 
Number of entries on CU-HDR queue 
Number of equipment checks 
Number of erase gaps 


Number of EXCPs 


Number of EXCP for address spaces 


Number of exposures for a multiple 
exposure device 


Number of extents 


7-26 System Management Facilities (SMF) 


Record Offset 
Type Dec. Hex. 


39 24 68 
39 24 18 
39 20 14 
39 28 1C 
14 ISAM 

15 ISAM 

69 52 34 
19 56 38 


48* 60 3C 
48** 68 44 


48** 69 45 


79 DEV section 
75 144 90 


14 TAPU 
15 TAPU 
6 56 38 


14 54 36 
15 54 36 


25** 48 30 
25°22 48 


19 46 2E 
19 48 30 


70 Paging data section 
79 Subtype 1 (ASD and ASDJ) data section 
79 Subtype 1 (ASD and ASDJ) data section 


79 CHANNEL section 
79 Subtype 14 1/O queuing section 
48** 69 45 


21 39 27 
4 DEV 

14 UCB 

15 UCB 

30 EXCP section 
34 DEV 

40 DEV 

48 52 34 
64 STAT 


30 1/O activity section 


74 Device control data section 


14 UCB 
15 UCB 
64 STAT 











c 





*These records are for JES2. 
**These records are for JES3. 


Field Description 


Number of extents in independent 
index, prime data, and independent 
overflow areas 


Number of extents released by DADSM 
routine 


Number of feet of document printed 
Number of fonts loaded 

Number of fonts used 

Number of FORMDEFS used 


Number of 4k frames in this 
contiguous block 


Number of frames 
available 


common pageable and fixed 
common/private fixed 
LPA/CSA fixed 

LPA/CSA pageable 
LSQA/non-LSOA fixed 


SOA 
Number of free data space extents 


Number of full cylinder overflow areas 


Number of full SMF buffers 
Number of inbound PIUs 
Number of interventions requried 


Number of I/O requests for a data set 


Number of LAN sections 


Number of line errors 


Number of lines per page 


Number of logical records in overflow 
and prime data areas 


Number of logical records written 
Number of lost datas 
Number of LPDA-2 sections 


Number of negative acknowledgements 
to write text 


Number of negative acknowledgements 
to write text 


Number of noise blocks 

Number of non-specific DASD mounts 
Number of non-specific tape mounts 
Number of non-specific MSS mounts 


Number of non-V!IO, non-swap page-ins 


Record Offset 
Type Dec. Hex. 


14 ISAM 

tS ISAM 

14 DCB 

15 DCB 

6* 64 40 


6* 40 28 
6* 36 24 
6* 72 48 


22 Extended storage section 


71 Paging data section 
79 SPAG section 

79 SRCS section 

79 SRCS section 

79 SRCA section 

79 SRCS section 

79 SRCS section 

79 ARD/ARD4J section 
79 SRCS section 

79 SRCS section 


69 46 2E 


14 ISAM 
15 ISAM 


23 Statistics section 
50 44 2C (5735-RC2) 
48** 65 41 


75 Page/Swap data set data section 
79 Subtype 11 (PGSP) data set section 


37 76 4c 
48* 68 Aa 
48** 56 38 
26* 130 82 
14 ISAM 

15 ISAM 

6 51 33 
48** 70 46 
37 68 44 
48* 56 38 
48** 62 3E 


48* 56 38 
48** 62 3E 


21 38 26 
30 Operator section 
30 Operator section 


30 Operator section 


4 REL 
30 Storage and paging section 
34 REL 


Chapter 7. Field-to-Record Cross-Reference 7-27 


Record Offset 
Field Dsscription Type Dec. Hex. ~ 
Number of non-V1O, non-swap 4 REL 
page-outs 30 Storage and paging section 
34 REL 


Number of non-VIO page reclaims 30 Storage and paging section 


Number of outbound PIUs 50 50 32 (5 735-RC2) 

Number of output lines 26 116 46 

Number of output lines generated 26* 212 D4 

to spool 26** 252 FG 

Number of output punched cards 26 120 78 

Number of overlays loaded 6* 48 30 

Number of overlays used 6* 44 2C 

Number of page seconds 4 REL 
30 Storage and paging section 
34 REL 

Number of page segments loaded 6* 56 38 

Number of page segments used 6* 52 34 

Number of PAGEDEFS 6* 68 44 

Number of pages-current transaction 79 Subtype 2 (ARD/ARD4J) data section 

Number of pages in real contiguous 22 STOR 


storage 


eee 
*These records are for JES2. 


**These records are for JESS. 


Number of pages moved to frames 
above or below the 16-megabyte line 


Number of pages printed 


Number of pages stolen 


Number of pages swapped in 


Number of pages swapped out 


Number of pages transferred 


71 Paging data section 


6 
4 


88 
REL 


: Y 


30 Storage and paging section 


34 
4 


REL 
REL 


30 Storage and paging section 


34 
4 


REL 
REL 


30 Storage and paging section 


34 
75 


79 PGSP section 


REL 
152 


98 


Number of permanent read errors 21 36 24 
Number of permanent write errors 21 37 25 
Number of read or write accesses to an 14 ISAM 

overflow record 15 ISAM 
Number of read buffers used 50 52 34 (5735-RC2) 
Number of reclaims 4 REL 

34 REL 

Number of records deleted, inserted, 64 STAT 

updated, and retrieved from 

component 
Number of records in component 64 STAT 
Number of records lost 7 18 12 


Number of records sorted 


Number of records transmitted 
or received 


7-28 System Management Facilities (SMF) 


16 Data section 


24 General section 





C 


*These records are for JES2. 


**These records are for JES3. 


Field Description 


Number of response-time 
data sections 


Number of route data sections 


Number of samples 


Number of samples in an interval 


Number of samples indicating that 
the control unit is busy 


Number of samples indicating that 
the data set is being used by ASM 


Number of samples indicating a delay 
because a loosely-coupled processor 
reserved the device 


Number of samples indicating that the 
device was allocated 


Number of sample indicating that the 
device was busy while the control 
was not 


Number of samples indicating that the 
device was not ready 


Number of samples indicating that the 
device was reserved 


Number of samples indicating that the 
physical channel was in burst mode 


Number of samples indicating that the 
physical channel was in a wait state 


Number of session configuration 
sections 


Number of slots 
bad 
total 


used, min/max 


unused 
Number of SMF records written 
Number of split control areas 
Number of split control intervals 
Number of SSCHs 


Number of step 


Record Offset 

Type Dec. Hex. 
39 20 1E 
39 22 16 


70 Product section 

71 Product section 

73 Product section 

74 Product section 

75 Product section 

76 Product section 

78 Product section 

78 Subtype 2 (virtual storage) private area data section 
79 Subtype 9 (DEV) device data section 


79 Subtype 9 (DEV) device data section 
79 Subtype 9 (DEV) device data section 


75 140 8C 


79 PGSP section 


74 Device section 


74 Device section 
79 DEV section 


79 DEV section 


74 Device section 


74 Device section 


79 CHANNEL section 


79 CHANNEL section 


39 14 E 


79 DDMN section 


75 120 78 
79 PGSP section 

75 124 7C 
75 128 80 


79 PGSP section 
75 136 88 


23 Statistics section 


64 STAT 
64 STAT 
21 34 22 


74 16 10 
79 16 10 


4 42 2A 
30 Identification section 
34 42 2A 
40 42 2A 


Chapter 7. Field-to-Record Cross-Reference 7-29 


*These records are for JES2. 


**These records are for JESS. 


Field Description 


Number of steps in job 


Number of swap candidates 
Number of swap-ins 


Number of swap sequences 


Number of swaps migrated from 
extended storage 


Number of specific DASD mounts 
Number of specific MSS mounts 
Number of specific tape mounts 
Number of tape volumes requested 


Number of tape volumes mounted 
by MDS 


Number of temporary read errors 
Number of temporary write errors 


Number of terminal input lines 


Number of terminal output lines 


Number of text bytes sent from 
primary to secondary 


Number of text bytes sent from 
secondary to primary 


Number of text PIUs sent from 
primary to secondary 


Number of text PIUs sent from 
secondary to primary 


Number of TGETs 


Number of times NCP entered 
slowdown 


Number of time-outs to read text 


Number of time-sharing buffers 


Number of TPUTs 


Number of tracks allocated on device 


Number of tracks in largest 
unallocated extent 


Number of tracks in largest continuous 
unallocated area 


Number of tracks in overflow area 


7-30 System Management Facilities (SMF) 


Record Offset 


Type Dec. Hex. 


5 42 2A 
30 Identification section 
35 42 2A 


70 Swap placement section 
79 SPAG section 


4 REL 
30 Storage and paging section 
34 REL 


70 Swap placement section 


30 Operator section 
30 Operator section 
30 Operator section 
25** 44 2C 
25** 68 44 


21 32 20 
21 33 21 
30 1/0 activity section 
34 51 33 
35 51 33 


30 I/O activity section 
34 47 2F 
35 47 2F 


39 40 28 


39 48 30 


39 36 24 


39 44 2C 


30 1/0 activity section 
32 TSO command section 


50 58 3A 


48* 64 40 
48** 60 3C 


31 18 12 


30 I/O activity section 
32 TSO command section 


14 UCB 
15 UCB 


19 58 3A 


69 54 36 


14 ISAM 
15 ISAM 








c 


*These records are for JES2. 


**These records are for JESS. 


Field Description 


Record Offset 
Type Dec. Hex. 


a eee, 


Number of tracks released by DADSM 


routine 


Number of tracks requested but not 
allocated 


Number of tracks used by sort 


Number of transactions 


Number of TSO commands 


Number of unallocated cylinders 


Number of unallocated extents 


Number of unallocated tracks 


Number of unused alternate tracks 
Number of unused control intervals 


Number of VIO and non-VI1O pages 
for current transaction 


Number of VIO page reclaims 


Number of VIO page-ins 


Number of VIO page-outs 


Number of volumes 


Number of work data sets used 


Number of work data sets used 
Offset to LPDA-2 section 
Offset to LAN section 

Offload data set name 

Old catalog record 

Old catalog record size 

Old data set name 


Old entry name 


OPEN routine indicator 


Open status indicator 
Operating system release level 
Operators name 


OPT member used 
old/new 


OPTCD=J 
Options, SMF 


14 DCB 
ES DCB 
64 132 84 


16 Data section 


30 Performance section 
35 88 58 
39 24 18 


32 Command section 


1g 52 34 
69 48 30 


+9 60 3C 


19 54 36 
69 50 32 


19 50 32 
64 STAT 
79 Subtype 2 (ARD/ARD4J) data section 


30 Storage and paging section 


4 REL 

30 Storage and paging section 
34 REL 

4 REL 

30 Storage and paging section 
34 REL 

17 91 5B 

18 135 53 

62 140 58 


16 Data section 


16 Data section 
37 62 3E 
37 70 46 


24 General section 


63 136 54 
63 46 2E 
18 44 2C 
66 120 78 
68 86 56 
14 249 F9 
15 249 F9 
62 42 2A 


23 System section 
90 IPL PROMPT section 


90 IPL SRM section 
90 SET OPT section 


6 PRNT 


0 30 1E 
90 SMF section 


Chapter 7. Field-to-Record Cross-Reference 7-31 


Record Offset 
Field Description Type Dec. Hex. 
Output form number 26* 124 4E 
Output lines, number of 26 116 74 
Ouptut lines generated to spool, 26* 212 D4 
number of 26** 250 100 
Output priority 6** 94 5E 
Output processor (CPU) identification 26* 232 E8 
26** 272 110 
Output processor start time and date 26* 188 BC 
26** 228 E4 
Output processor stop time and date 26* 196 C4 
26** 236 EC 
Output punched cards, number of 26 120 78 


Output selection priority 


Overlay name 


24 SYSOUT selection criteria section 
6 PRNT 


Overlays, number loaded 6 48 30 
Overlays, number used 6 44 2C 
OWAIT threshold 31 28 LC 
Owner identification of direct access 19 26 1A 


volume 


Page count, printed 
actual 
estimated 


Page data set slots 


26* Print section 
26* Print section 


allocated to VIO 71 128 80 

allocated to non-VIO 71 132 84 

total number 71 124 7G 

unallocated 71 136 88 
Page movement rate, total 71 348 15C 
Page reclaims, LPA 4 REL 


30 Storage and paging section 
34 REL 


71 88 58 
Page reclaims, non-VIO, non-swap 71 64 40 
Page seconds 4 REL 


30 Storage and paging section 
34 REL 


Page segments, number loaded 6 56 38 
Page segments, number used 6 52 34 
PAGEDEFS, number used 6 68 44 
Page-ins, LPA 4 REL 


Page-ins, non-VIO, non-swap 


30 Storage and paging section 
34 REL 
71 104 68 


4 REL 

30 Storage and paging section 
34 REL 

71 56 38 





*These records are for JES2. 
**These records are for JESS. 
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*These records are for JES2. 


**These records are for JES3. 


Field Description 


Page-ins, VIO 


Page-outs, non-VIO, non-swap 


Page-outs, VIO 


Pages, number in real contiguous 
storage 


Pages, number moved to frames above 
or below the 16-megabyte line 


Pages, number of printed 
Pages, stolen 


Pages swapped in, number of 


Pages swapped out, number of 


Password 


Performance class name 


Performance group number 


Performance group number (continued) 


Performance group number, highest 
defined in IPS 


Permanent read errors, number of 
Permanent write errors, number of 


PG number, highest defined in 
IPS or ICS 


Physical unit (PU) name for SLU 


PLU domain name 


Record Offset 


Type Dec. Hex. 


4 REL 

30 Storage and paging section 
34 REL 

71 Paging data section 


4 REL 

30 Storage and paging section 
34 REL 

71 Paging data section 


4 REL 

30 Storage and paging section 
34 REL 

71 Paging data section 


22 STOR 


71 Paging data section 


6 88 58 

30 Storage and paging section 
4 REL 

30 Storage and paging section 
34 REL 

71 Paging data section 

4 REL 

30 Storage and paging section 
34 REL 

71 76 4C 


47 44 2C 
48 44 2C 
49 44 2C 
54* Identification section 
55* 34 22 
55* 42 2A 
56* 34 22 
56* 42 2A 


39 82 52 


4 REL 

5 92 5C 

30 Identification section 

32 Identification section 

34 REL 

35 92 5C 

79 Subtype 3 (ARD/ARD/J) data section 
79 Subtype 3 (ASD/ASDJ) data section 

79 Subtype 5 (ASRM/ASRM4J) data section 
79 Subtype 8 (TRX) data section 


21 36 24 
21 37 25 
72 4 4 


39 50 32 
39 34 22 


Chapter 7. Field-to-Record Cross-Reference 7-33 


Field Description 





PIUs, number inbound 

PIUs, number outbound 

PLU subarea physical unit (PU) 
Positive response count, RECEIVE 
Positive response count, SEND 
Print copy count, job 

Print route code, job 

Print/punch processor start time 


Printed byte count 
actual 
estimated 


Printed page count 
actual 
estimated 


Priority , address space dispatching 


Priority, job 


Priority, job selection 


Priority, logon 


Priority, output selection 


Primary link name 
Primary logical unit (PLU) name 
Primary physical unit (PU) name 


Private area, storage used from 
bottom of 


Private area, storage used from top of 


Private area size in bytes, below and 
above 16 megabytes 


Procedure DDNAME 
Procedure name, JES3 
Processor time used by sort 


Product name 


Record Offset 
Type Dec. Hex. 
50 46 2E ($735-RC2) 
50 50 32 (5735-RC2) 


39 26 1A 
48** 66 42 
4g** 64 40 


26* 128 80 
26* 132 84 


6* 43 2B 


26 Print section 
26 Print section 


26 Print section 
26 Print section 


4 57 39 
30 Processor section 
34 57 39 


5 57 39 
30 Identification section 
35 57 39 
26 90 5A 
26 91 5B 
30 Identification section 
35 57 39 


6** 94 5E 
24 SYSOUT selection criteria 
26* 92 5C 
26* 93 5D 


39 18 12 


39 2 2 
39 10 A 
4 78 4E 


30 Storage and paging section 
34 78 4E 
78 Private virtual storage section 


4 76 4c 

30 Storage and paging section 
34 76 4c 

78 Private virtual storage section 


30 Storage and paging section 
78 Common virtual storage section 
78 Private virtual storage section 


26 136 88 
43** 38 26 
16 Data section 


30 Product section 
32 Product section 
90 Product section 





*These records are for JES2. 
**These records are for JES3. 


7-34 System Management Facilities (SMF) 


L 


*These records are for JES2. 


**These records are for JES3. 


Field Description 


Program name 


Program start time 


Programmed Cryptographic Facility 

CKDS activity flags 

function code 

installation exit data 

job/step name, RACF user/ 
group flag 

number of variable relocate 
sections 

options 

return code 


Programmer's accounting number 


Programmer's building 


Programmer's department 


Programmer's name 


Programmer's room number 


Punch route code, job 
Punched cards, number of 


Punched cards generated to spool, 
number of 


RACF Group ID 


RACF Terminal ID 


RACF User ID 


RBA, highest used 
READ buffers used 
READ channel programs 


Read errors, number of 


Read or write accesses to an overflow 
record, number of 


Reader device class 


Record Offset 


Type Dec. Hex. 
4 58 3A 
30 Identification section 
34 58 3A 
78 Private virtual storage section 
4 94 5E 
34 94 5E 
82 (5740-XY5) 
82 KG 
82 43 2B 
82 IDAT 
82 40 28 
82 41 29 
82 CRYP 
82 44 2C 


26* 104 68 


26** 390 186 
59 98 62 


26** 382 175 


59 90 5A 
5 97 61 
30 {dentification section 
20 44 2C 
26 68 44 
57** 46 2E 
59 62 3E 


26* 108 8C 
26* 398 18E 
59 82 52 


26* 134 86 


26 120 78 
26* 216 D8 
26** 256 100 
20 REL 


30 Identification section 
32 Identification section 


20 REL 
30 Identification section 
32 Identification section 
20 REL 
30 Identification section 
32 Identification section 


64 134 86 


50 54 36 (5735-RC2) 
50 34 22 (5735-RC2) 
21 32 20 

21 36 24 

14 {SAM 

15 ISAM 

5 73 49 


30 1/O activity section 


Chapter 7. Field-to-Record Cross-Reference 


Record Offset 
Field Description Type Dec. Hex. ) 
Reader device type 30 1/0 activity section 


Reader end date 5 62 3E 
30 Identification section 
26* 152 98 
26** 192 co 


Reader end time 5 58 3A 
26* 148 94 
26** 188 BC 
30 Identification section 





Reader start date 4 30 1E 
5 30 1E 
6 30 1E 
10 30 1E 
14 30 1E 
15 30 1E 
17 30 1E 
18 30 1E 
20 30 1E 
25** 30 1E 
26 30 1E 


30 Identification section 
32 Identification section 





40 30 1E 
Reader start date 60 62 3E 
61 62 3E 
62 30 1E 
63 30 1E 
64 30 1E 
65 62 3E 
66 62 3E 
67 30 1E 
68 30 1E 
69 30 1E 
78 Private virtual storage section 
Reader start time 4 26 1A 
5 26 1A 
6 26 1A 
10 26 1A 
14 26 1A 
17 26 1A 
18 26 1A 
20 26 1A 
25*°* 26 1A 
26 26 1A 


30 Identification section 
32 Identification section 


40 26 1A 
60 58 3A 
61 58 3A 
62 26 1A 
63 26 1A 
64 26 1A 
65 58 3A 
66 58 3A 
67 26 1A 
68 26 1A 
69 26 1A 


78 Private virtual storage section 





**These records are for JESS. 


7-36 System Management Facilities (SMF) 


Record Offset 





Field Description Type Dec. Hex. 
Reader unit type 5 74 4A 
30 1/O activity section 
RECEIVE count 48** 56 38 
RECEIVE level ib DBm 37 12 C 
RECEIVE Level in DBm, minimum 3/7 14 E 
RECEIVE, negative response count 48** 62 3E 
RECEIVE, positive response count 48** 66 42 
Real storage, number of bytes in 0 31 LE 
Record format 14 246 F6 
15 246 F6 
Record indicator 4 102 66 
14 42 2A 
15 42 2A 
22 18 12 
30 Completion section 
34 102 66 
40 a4 2C 
47 24 18 
48 24 18 
49 24 18 
60 74 4A 
61 74 4A 
63 42 2A 
65 74 4A 
66 74 4A 
67 42 2A 
Record size, maximum logical 64 DSC 
Record subtype 24 22 16 
60 22 16 
61 22 16 
65 22 16 
66 22 16 
Records, logical, number written 6 51 33 
Records deleted, inserted, updated, and 64 STAT 
retrieved from component, number of 
Records in component, number of 64 STAT 
Records in overflow and prime data 14 ISAM 
areas, number of logical 15 ISAM 
Record type ALL 5 5 
Records lost, number of 7 18 12 
Records transmitted or 24 General section 
received, number of 
Recording data set new/old 90 Subsystem recording section 
Region requested 78 Private virtual storage section 
Region size, maximum possible 78 Common virtual storage section 
Region size established or assigned 4 82 52 
30 Storage and paging section 
34 82 52 


78 Private virtual storage section 


Chapter 7. Field-to-Record Cross-Reference 7-37 


Field Description 


Record 
Type Dec. Hex. 


Offset 


SSS ee c  O 


Relative address of last record 
processed for a physical sequential 
or partitioned data set 


Relative byte address, highest used 
Release number of operating system 


Remote name 


Requests for disk/volume, number of 


Requests queued for the logical 
control unit 


Requests queued in IOS for the device 


Reserve, address of the device 
against which is issued 
Reserve, name of the job that issued 


Reserve, system identifier for the job 
that issued 


RESTART threshold 
Resource 
number of requests 
major/minor name 
max/min/total contention 


Resource factor coefficient 
CPU 
ERV 
ioc 


Resource name, failing 
Resource type, failing 
Response delay, total 
Response time definition 
RETKEY flags 


RETKEY key name 
Reverse explicit route number 


RMF samples, number of 
RMF version number 


Room number, programmers 


Route code 


14 DCB 
15 DCB 


64 134 86 
90 IPL SMF section 
24 SYSOUT selection criteria section 


47 28 1C 
48 28 1C 
49 28 1c 


52* Identification section 
54* Identification section 


25** 48 30 
78 Subtype 1 1/O queuing data section 


74 Device data section 
79 Subtype 9 device data section 


79 Subtype 6 (SENQR) data section 


79 Subtype 6 (SENQR) data section 
79 Subtype 6 (SENQR) data section 


31 30 1E 


77 Enqueue section 
77 Enqueue section 
79 Subtypes 6 and 7 (SENQ/SENOR) data sections 
77 Enqueue section 


72 Workload control section 
72 Workload control section 
72 Workload control section 


37 All section 
37 All section 
39 28 1C 


39 22 16 
82 RETK 

82 RETK 

39 100 64 
70-79 +24 18 
70-79 O 0 


26* 108 6C 
26** 398 18E 


6* 92 5C 
6* Routing section 

26* 94 5E 
26* 132 84 
26* 134 86 
26* Routing section 








*These records are for JES2. 
“*These records are for JES3. 


7-38 System Management Facilities (SMF) 


Record Offset 
( Field Description Type Dec. Hex. 


Route element name 39 0 0 
Route element table 39 6 6 
Sample sets in RMF trace number of 76 0 0 
Samples, invalid 78 2 2 
Sampling cycle length 70-79 36 24 
Security Product ID 82 22 16 
Segment descriptor 39 2 2 
Selection attempts delayed by 78 16 10 
control unit busy 

Selection attempts, total 78 Subtype 1 (I/O queuing data section) 
SEND count 48** 52 34 
SEND, negative response count 48** 60 3C 
SEND, positive response count 48** 64 40 
Service, CPU 4 REL 

5 REL 

30 Perforamnce section 

34 REL 

35 REL 
Service, 1/O 4 REL 

5 REL 

30 Performance section 

34 REL 

35 REL 
Service, job 5 80 50 

ww 30 Performance section 

35 80 50 
Service, main storage 4 REL 

5 REL 

30 Performance section 

34 REL 

35 REL 
Service, MSO units 30 Performance section 
Service, SRB 4 REL 

5 REL 

30 Performance section 

34 REL 

35 REL 
Service, step 4 REL 

30 Performance section 

34 REL 
Service, total 30 Performance section 


= *These records are for JES2. 


**These records are for JES3. 


Chapter 7, Field-to-Record Cross-Reference 7-39 


Field Description 


Type Desc. Hex 





Session name 

SID parameter 
Situation indicator 
SIOT TTR address 


Size of catalog record 


Size of control interval 


Size of private area 


Size of terminal status block 
Size of time-sharing buffer 
SLU domain name 

SLU link name 

SLU subarea PU 

SMF options 


Sort 
number of records processed 
processor time used 


Spindle identification 


SRB service 


SRB service definition coefficient 


SRM measure of the ASM queue 
length 


SRM service for a step 
SQA usage 

SQA size 

SSID of device 
Staging adapters 


Staging spindles in staging data 
groups 


7-40 System Management Facilities (SMF) 


79 6 6 
ALL 14 E 
64 42 2A 
14 64 40 
15 64 40 
63 44 2C 
63 46 2E 
67 132 84 
DSC 

4 74 4A 
34 74 4A 
31 36 24 
31 20 14 
39 74 4A 
39 58 3A 
39 74 4A 
0 30 1E 


90 SMF command section 


16 Data section 
16 Data section 


64 EXT 

69 BA 2C 
4 REL 

5 REL 

30 Performance section 
34 REL 

35 REL 

72 38 26 


79 Subtype 3 (SRCS) data section 


79 Subtype 2 (ARD/ARDJ) data section 
78 Common virtual storage section 

78 Common virtual storage section 

22 VAR 

22 MSS 

22 MSS 





‘S 


*These records are for JES2 


Fieid Description 


Start date 
job transmitter 
SYSOUT transmission 


Start date of recording when SMF data 
set became available 


START SSCH instructions, number of 


Start time 
job transmitter 
SYSOUT transmitter 


Start time of recording when SMF 
data set became available 


Start/warm start indicator 


Step accounting fields 


Step completion code 


Step CPU time 


Step initiation time 


Step initiation date 


Step name 


Step number 


Step performance group number 


Step service 


Step termination date 


Step termination indicator 


Record Offset 
Type Dec. Hex. 


26* Network section 


57* 76 4c 
7 24 18 
21 34 22 


74 Device data section 
79 Subtype 11 (PGSP) data set section 


26* Network section 


57* 72 48 
7 20 14 
43 26 1A 
4 ACT 

30 Accounting section 
34 ACT 

4 55 37 
30 Completion section 
34 55 37 
4 99 63 
4 ACT 

30 Processor accounting section 
34 99 63 
34 ACT 


30 Identification section 
32 Identification section 


30 Identification section 
32 Identification section 


4 66 42 
30 Identification section 
32 Identification section 


34 66 42 

78 Private virtual storage section 

82 32 20 (5740-XY5, -XY6) 
4 42 2A 


30 Identification section 
32 Identification section 


34 42 2A 
40 42 2A 
4 REL 

5 92 5C 


30 Identification section 
32 Identification section 


34 REL 

35 92 5C 
4 REL 

34 REL 

4 10 A 
30 10 A 
34 10 A 

4 87 53 
30 Completion section 
34 87 53 


Chapter 7. Field-to-Record Cross-Reference 7-41 


*These records are for JES2. 


Field Description 


Record 
Type Dec. Hex. 


Offset 





Step termination time 


Step transaction active time 


Step transaction residency time 


Stop date 
job transmitter 
SYSOUT transmitter 


Stop time 
job transmitter 
SYSOUT transmitter 


Storage, extended, number of 
4k frames 


Storage, real, number of bytes in 


Storage, used from bottom of 
private area 


Storage, used from top of private area 


Storage, virtual, number of bytes in 


Storage protect key 


Subpool usage 


Subsystem associated with PGN 


Subsystem identification 


Subsystem identification of device 


7-42 System Management Facilities (SMF) 


4 6 6 

30 6 6 

34 6 6 

4 REL 

30 Performance section 
34 REL 

4 REL 

30 Performance section 
34 REL 


26* Network section 
57* 84 54 


26* Network section 
57* 80 50 


22 Extended storage section 


0 31 1F 


4 78 4E 

30 Storage section 

34 78 4E 

78 Private virtual storage section 


4 76 4C 

30 Storage section 

34 76 4C 

78 Private virtual storage section 


0 26 1A 
4 86 56 
5 76 4C 


30 Storage section 
34 86 56 
35 76 4C 


78 Common virtual storage secton 
78 Private virtual storage section 


72 58 3A 


6 62 3E 
26 46 2E 
30 18 12 
32 18 12 
43 18 12 
45 18 12 
47 18 12 
48 18 12 
49 18 12 


22 VAR 





Record Offset 
C Field Description Type Dec. Hex. 


Swap candidates, number of 71 Swap placement section 
Swap sequences, number of 4 REL 
30 Storage and paging section 
34 REL 
71 Swap placement section 
Swap-ins, number of 4 REL 
30 Storage and paging section 
34 REL 
Swap-outs, number of 4 REL 
30 Storage and paging section 
34 REL 
Swaps, 
directed to auxiliary storage 
logical 71 Swap placement section 
physical 71 Swap placement section 
directed to extended storage 
phy sical 71 Swap placement section 
migrated from extended storage 71 Swap placement section 
SYSOUT class 6 42 2A 
24 SYSOUT selection criteria section 
SYSOUT transmitter 
start date 57* 76 4C 
start time 57* 72 48 
stop date 57* 84 5A 
stop time 57* 80 50 
system identifier 57* 96 60 
System identification ALL 14 E 
26* Network section 
System identification from $E SYS 43* 28 1C 
command 
System indicator ALL 4 4 


* These records are for JES2. 
** These records are for JES3. 


Chapter 7. Field-to-Record Cross-Reference 7-43 


Reeord Offset . 
Field Description Type Dec. Hex. 


System name (if NJP) 26** 96 60 
26** 144 90 
26** 152 98 





Tape density 21 43 2B 
Tape unit serial 21 47 2F 
Tape volumes requested, number of 25** 44 2C 
TCB time for step 79 ARD/ARDS section 
Temporary read forward errors 21 50 32 
Temporary read errors, number of 21 32 20 


(non-buffered log) 
Temporary read backward errors 21 52 34 


Temporary write errors, number of 21 33 21 
(non buffered log) 


Temporary write errors, number of 21 54 36 
Terminal input lines, number of 30 I/O activity section 
34 51 33 
35 51 33 
Terminal output lines, number of 30 1/0 activity section 
34 47 2F 
35 47 2F 
Terminal status block, size of 31 36 24 


Terminal wait 
number of logical swapout candidates 71 Swap placement section 





Termination indicator, JES2 or JES3 45 24 18 
Termination indicator, job 5 66 42 
30 Completion section 
35 66 42 
Termination indicator, step 4 87 57 
30 Completion section 
34 87 57 
TGET, count for group 32 Command section 
TGETs satisfied, number of 30 1/0 activity section 
34 51 33 
35 51 33 
Time, continuous weit Q 18 12 
Time, deadline schedule 26** 168 A8 
Time, execution 26 112 70 
Time, JES3 allocation requests 25** 76 4c 
Time, JES3 device verification 25°° 84 54 
Time, job CPU 5 77 40 
5 117 75 
30 Completion section 
35 77 4D 


35 117 75 





*These records are for JES2. 
**These records are for JES3. 


7-44 System Management Facilities (SMF) 


c 


*These records are for JES2. 


**These records are for JESS. 


Field Description 


Record Offset 
Type Dec. Hex. 





Time, IPL 
Time, logoff 


Time, logon 


Time, logon enqueue 


Time, step CPU 


Time, job transaction active 


Time, step transaction active 


Time, transaction queued 

Time, transaction completed 
Time *START SETUP command 
issued 

Time converter started 


Time converter stopped 


Time device allocation started 


Time execution processor started 


Time execution processor stopped 
Time fetch procassing ended 


Time ail volume mount message 
issued 


Time initiator selected step/job 


Time job terminated 


Time output processor started 


Time output processor stopped 


Time output service started 


90 Seif-defining section 


30 6 6 

35 6 6 

30 6 6 

34 26 1A 
35 26 1A 
30 Identification section 
35 58 3A 

4 99 63 

4 ACT 

30 Processor activity section 
34 99 63 
34 ACT 

5 84 54 
30 Performance section 
35 84 54 

4 REL 

30 Performance section 
34 REL 


59 Transaction data 
59 Transaction data 
25** 60 3C 


26° 156 9C 
26°° 196 C4 


26° 164 AG 
26°° 204 cc 


é, 90 5A 
30 identification section 
32 Identification section 
34 90 5A 


26° 172 AC 
26*°* 212 D4 


26° 180 B4 
26°* 220 DC 


25°" 52 34 
25°" 76 4c 
& 43 2B 
5 43 2B 


30 identification section 
32 Identification section 


34 43 2B 

5 6 6 

30 6 6 

32 Identification section 
35 8 6 


26* 188 BC 
26°* 228 E4 


26* 196 C4 
26°* 236 EC 


6°* 43 2B 


Chapter 7. Field-to-Record Cross-Reference 7-45 


*These records are for JES2. 
**These records are for JES3. 


1 Except 2, 3 


Field Description 


Record Offset 





Time-outs to read text, number of 


Time print/punch processor started 
Time program started 


Time reader recognized end of job 


Time reader recognized the JOB card 


Time record was moved to dump 
data set 


Time record was moved to SMF buffer 


Time recording was started when SMF 
date set became available 


Time step terminated 


Time-sharing buffer size 
Time-sharing buffers, number of 


Time, transaction active, elapsed, 
residency 


TIOT status indicator 
TPUT count for group 


TPUTs issued, number of 


Trace options 


7-46 System Management Facilities (SMF) 


Type Dec. Hex. 
48° 64 40 
48** 60 3C 
6* 43 2B 
4 94 5E 
30 Identification section 
34 Ga 5E 
§ 58 36 


26° 148 94 
26*°* 188 BC 
30 Identification section 
32 Identification section 


4 26 1A 
5 26 1A 
6 26 1A 
10 26 1A 
14 26 1A 
15 26 1A 
17 26 1A 
18 26 1A 
20 26 1A 
24 General section 

25** 26 1A 
26 26 1A 


30 Identification section 
32 Identification section 


40 26 1A 
60 58 3A 
61 58 3A 
62 26 1A 
63 26 1A 
64 26 1A 
65 58 3A 
66 58 3A 
67 26 1A 
68 26 1A 
69 26 1A 
78 Subtype 2 (Private virtual storage section) 
2 6 6 
3 6 6 
ALL’ <6 6 
7 20 14 
4 6 6 
30 6 6 
34 6 6 
31 20 14 
31 18 12 


30 Performance section 


14 53 35 
15 53 35 


32 Command section 
30 |/O activity section 


34 47 2F 
35 47 2F 
76 68 aa 








Se 


**These records are for JES3. 


Field Description 


Record Offset 





Tracks, number in largest 
unallocated extent 


Tracks, number of unallocated 


Tracks, number of unused alternate 
Tracks, number used by sort 


Tracks allocated on device, number of 


Tracks in largest continuous 
unallocated area, number of 


Tracks in overflow area, number of 


Tracks released by DADSM routine, 
number of 


Tracks requested but not allocated, 
number of 


Transaction active time 


Transaction active time, job 


Transaction active time, step 


Transaction name associated with PGN 
Transaction class name 


Transaction elapsed time 


Transaction residency time 


Transaction residency time, job 


Transaction residency time, step 


Transactions, number of 


Transactions, number for group 
Transmission group number 
Transmission path 

Transmission priority 

TSB (terminal status block), size of 
TSO user identification 

TSO, command name 

TSO, number of commands 

TTR of JFCB or SIOT 


Type Dec. Hex. 
19 58 3A 
19 54 36 
69 50 32 
19 50 32 


16 Data section 


14 UCB 

15 UCB 

69 54 36 
14 ISAM 

15 ISAM 

14 DCB 

15 DCB 


64 132 84 


30 Performance section 


5 88 58 
30 Performance section 
35 88 58 

4 REL 

30 Performance section 
34 REL 

72 82 52 


79 Subtype 8 (TRX) data section 


30 Performance section 
79 Subtype 5 (ASRM/ASRM\J) data section 


30 Performance section 
79 ASRM/ASRMJ section 


5 68 44 
30 Performance section 
35 68 44 
4 REL 

30 Performance section 
34 REL 


30 Performance section 
32 TSO/command segment 


35 88 58 
72 Performance section 
79 TRX section 

32 Command section 
39 8 8 
57** 146 9A 

39 104 68 

31 36 24 
26** 96 60 


32 Command section 
32 Command section 


14 64 40 
15 64 40 


Chapter 7, Field-to-Record Cross-Reference 7-47 


Record Offset 








Field Description Type Dec. Hex. 
TTRN of last record processed for a 14 DCB 
physical sequential or partitioned 15 DCB 
data set 
Type of deadline schedule 26** 124 7C 
Type of 1/O macro instruction and 14 247 F7 
options 15 247 F7 
UCS image identification 6 88 58 
24 SYSOUT selection criteria section 
UIC 
average high 70 Paging data section 
maximum high 70 Paging data section 
minimum high 70 Paging data section 
Unique session 1D (PCID) 39 106 6A 
Unit address, cryptographic 82 Cryptographic unit section (5740-XY6) 
Unit status, cryptographic 82 Cryptographic unit section (5740-X Y6) 
Unit type 5 74 4A 
8 DEV 
9 DEV 
10 DEV 
11 DEV 
14 UCB 
15 UCB 
19 36 24 
21 28 1C 
30 EXCP section 
34 DEV 
40 DEV 
62 VOL 
64 EXT 
75 103 67 
Unit type 74 12 C 
79 12 C 
Updated records, number of 64 STAT 
User identification 4 34 22 
5 34 22 
6 34 22 
10 34 22 
14 34 22 
15 34 22 
17 34 22 
18 34 22 
20 34 22 
25** 34 22 
26 34 22 


30 Identification section 
32 Identification section 


34 34 22 
35 34 22 
40 34 22 


57** 66 42 
60 66 42 





61 66 42 
62 34 22 
63 34 22 
65 66 42 
66 66 42 


**These records are for JESS. 


7-48 System Management Facilities (SMF) 


**These records are for JES3. 


Field Description 


User identification (continued) 


Vector Facility affinity time for 
initiator processing 


Vector Facility affinity time for 
job/step processing 


Vector Facility usage time for 
initiator processing 


Vector Facility usage time for 
job/step processing 


Vector Facility online indicator 


V1O page reclaims, number of 


VIO page-ins, number of 


VIO page-outs, number of 


VIO pages, accepted by data set 


Virtual route number 


Virtual storage allocated from LSQA 
and SWA 


Virtual storage allocated fror.1 user 
subpools 


Virtual storage, free 


Virtual storage, number of bytes in 


Virtual storage, used 


Volume mount completion message 
date 


Volume mount completion message 
time 


Volume owner identification 
Volume requests, MSS 


Volume sequence number 


Record 


Offset 
Type Dec. Hex. 


67 34 22 
68 34 22 
69 34 22 
82 24 18 


30 32 20 


30 28 1C 


30 24 18 


30 20 14 


22 CPU section 


4 REL 
30 Storage section 
34 REL 
4 REL 
30 Storage section 
34 REL 
4 REL 
30 Storage section 
34 REL 


75 Page/swap data set data section 
79 Subtype 11 (PGSP) data set section 


39 102 66 


30 80 50 
30 80 54 
78 Subtype 2 (Private virtual storage section) 


30 88 58 
30 92 5C 
78 Subtype 2 (Private virtual storage section) 


78 Subtype 2 (Common virtual storage section) 
78 Subtype 2 (Private virtus: z:torage section) 


0 26 1A 


78 Subtype 2 (Common virtual storage section) 
78 Subtype 2 (private virtual storage section) 


25** 80 50 


25** 76 4c 


19 26 1A 
Zo°" “92 5C 


14 254 FE 
15 254 PE 


Chapter 7. Field-to-Record Cross-Reference 7-49 


Record Offset 
Field Description Type Dec. Hex. ) 


Volume serial number 14 UCB 
15 UCB 
17 VOL 
18 VOL 
19 20 14 
21 20 14 


59 Transaction type section 

62 90 5A 

62 VOL 

64 EXT 

69 100 64 

74 Device section 

75 109 60 

79 Subtype 9 device section 

79 Subtype 11 (PGSP) data section 





Volume serial of the volume mounted 74 6 6 
79 Subtype 11 (PGSP) data section 
Volumes, number of 17 91 5B 
Volumes fetch messages, number of 25** 44 2C 
Volumes mounted by MDS, number ot 25** 68 44 
VSAM Volume data set name 60 75 4B 
VSAM Volume record 60 208 DO 
VTOC address 19 40 28 
VTOC indicator 19 45 2C 
Warm start/start indicator 43 26 1A 
Work station name 47** 28 1C 
48** 28 LC 
47** 28 1c 
Workload control section, offset to 72 36 24 
Worst Line Quality 37 8 8 
Write errors, number of 21 33 21 
21 37 25 





**These records are for JES3. 
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Chapter 8: EXCP Count 


SMF record types 4, 14, 15, 30, 32, 34, 40, and 64 have fields that contain a count 
related to the I/O activity for a given job, job step, or interval. These fields are 
called EXCP counts. There are two levels of EXCP counts; the DD level and the 


address space level. The type 30 record provides both levels; all other records 
provide only the DD level. 


DD Level 


The DD level EXCP count includes: 
e I/O for system services, for example: 
— Joblib/steplib processing 
— Jobcat/stepcat processing 
— Overlay supervisor processing 
— Checkpoint data set processing 
EXCPs issued via an EXCP macro (SVC 0) 
EXCPs issued via TCBEXCP macro (SVC 92) 
EXCPs issued via an EXCPVR macro (SVC 114) 


EXCPs issued in a system or user provided channel-end appendage 


EXCPs issued in an abnormal-end appendage 
I/O for VSAM data sets (SVC 121) 
EXCPs for VIO data sets 


EXCPs issued to the SYSUDUMP, SYSABEND, and SYSMDUMP data sets 
when these data sets reside on a direct access or tape device. 


The DD level EXCP count does not include: 
@ EXCPs issued in a PCI appendage when ADDRSPC=REAL 
@ EXCPs handled by the job entry subsystem 


e@ TPUTs and TGETs handled by macro instructions (For TPUTs and TGETs, 
EXCPs are accumulated on a system basis in the TCT and are contained in 
SMF record types 30, 32 (if detail is specified), 34 and 35 only.) 


For sequential access methods (BSAM, QSAM, and BPAM), the EXCP count 
represents a block count when default scheduling is used. That is, each end-of- 
block encountered in the problem program increases the EXCP count by one. 
For other access methods (such as BDAM, ISAM, and VSAM) the count repre- 
sents Start I/O requests. 


Only the type 6 and type 26 SMF records contain counts for a job or a job 
step I/O activity to spool data sets managed by either job entry subsystem. 
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Address Space Level 


The address space level EXCP count in the type 30 record contains all of the 
I/O counts described for the DD level, plus the following: 


Library searches and fetches from data sets in the LINKLIST. 

I/O initiated to the JES2 spool data sets from the address space being reported. 
Catalog management I/O activity. 

OPEN and CLOSE I/O activity beyond priming and purging the buffer. 


The address space EXCP level excludes all of the I/O counts that the DD level 


excludes, plus the following: 


Paging and swapping I/O activity. 
VTAM I/O activity 

JES3 spool I/O activity 

MSCC, OLTEP, and IOS retry 


Notes: 


1. 
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In SMF record types 14 and 15, the EXCP count accumulates over the entire job 
step. Therefore, if a data set is opened and closed twiced during a single job step, 
the count in the second record is the sum of all EXCPs for both uses of the data 
set. For multivolume files (such as tape files), the EXCP count is accumulated 
over the volumes. 


. The EXCP count in the last type 14 and 15 records for a given job step equals the 


corresponding entry for the data set in the type 4 and 34 records. 


. If aconcatenated data set contains more than one data set member with the 


same physical device, the EXCP count is accumulated in the first data set entry 
having that device entry. 


. If a GETMAN for the expanding TCTIOT data area (where the EXCP count is 


maintained) fails, only the existing data sets are counted. 


. If a data set is dynamically unallocated, the EXCP count is in record types 30 


and 40; there is no EXCP-count entry in record types 4 and 34. 





Chapter 9: CPU Time 


SMF record types 4,5, 30, 32, 34 and 35 have fields that contain the job and job 
step CPU times. This chapter summarizes the different times that are included 
and those that are excluded in these CPU-time fields. This chapter also lists a few 
examples of some of the major causes of CPU-time variation between different 
runs of the same job or job step. 


Job step-CPU time is the amount of time devoted by the central processing unit 
to the execution of instructions for a given job step. Job CPU time is the sum cf 
job step CPU times for all of the steps in a given job. CPU timing is done by the 
dispatcher on an address space basis. The accumulation of CPU time is separated 
into two fields: execution under TCBs and execution time under SRBs. 


CPU Time Under TCBs 


When a job step is set dispatchable by the initiator, the accumulated job step time 
field for tasks (ASCBEJST) is initialized to zero. Task CPU time is determined as 
follows: 


1. Whenever any task is dispatched, the CPU timer is set to the value of the task 
timer queue element (TQE). Jf a task TQE does not exist, the timer is set to a 


value that would not expire over a period of 208 days (208 day value). 

2. Whenever an I/O, program check, or external interrupt occurs, the CPU timer 
value is stored in PSACPUT. In addition, the value is stored: 
e By the dispatcher, when entered at the IEAODS entry point. 


e By the lock manager, when suspending a task for a local or any cross memory 
service locks. 


e By the program check FLIH suspend routine, when suspending a task for a 
page fix. 
3. Whenever STATUS is saved for a unit of work, the CPU time attributea tu the 
pre-empted task is accumulated in the ASCBEJST field as follows: 


a. If a task TQE does not exist, the CPU time is accumulated by adding the 
difference between the 208 day value and the PSACPUT to the ASCBEJST 
value. 


ASCBEJST=ASCBEJST+(208 day value-PSACPUT value) 
This excludes the interrupt handling and suspension time from the task time. 


b. If a task TQE exists and the CPU timer is not a negative value, the CPU time 
is accumulated by adding the difference between the TQE value and the 
PSACPUT value to the ASCBEJST value. 


ASCBEJST=ASCBEJST+(TQE value-PSACPUT value) 


c. Ifa task TQE exists and the CPU timer is a negative value, the CPU time is 
accumulated by adding the TQE value to the ASCBEJST value. 


ASCBJEST=ASCBEJST+TQE value 
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Notes: 





1. If the current task uses the Vector Facility (VF), the system also accumulates 
VF affinity time and VF usage time. 


e VF affinity time is a subset of job step time for tasks (ASCBEJST). When the 
task first uses a vector instruction, it is given affinity to only the processors 
that have the Vector Facility. It keeps this affinity until the dispatcher detects 
that vector instructions have not been used for a long time. If the dispatcher 
detects that vector instructions have not been used for a long time it removes the 
special affinity. VF affinity time is the job step time for tasks that was accumu- 
lated while the task had affinity to processors with the Vector Facility. This 
time is useful for capacity management of the Vector Facility. VF affinity time 
is accumulated in the ASSBVFAT field of the ASSB. 


e VF usage time isa subset of the VF affinity time. It is the time that the task 
actually spent executing vector instructions. VF usage time is accumulated in 
the ASSBEVST field of the ASSB. 


(The units for VF affinity and VF usage time are the same units as TCB time) 


2. If the current task is the RCT task, CPU time is not accumulated. This elimi- 
nates the time that is spent in swap-out/swap-in processing and its purging of 
I/O. In the case of page faults that result in suspension of the current task, the 
PSACPUT value represents the CPU timer value when the program check (page 
fault) occurred. In the case of a synchronous page fix that results in suspension 
of the current task, the CPU timer is stored in the PSACPUT field during the 
suspend processing so that the suspension time is not included in the ASCBEJST. 
The result is that suspend time is excluded from the task time. 


CPU timing is continually accumulated as described above until the job step —wi 
terminates. At that time the CPU time in the ASCBEJST field is moved into the 

ACTJTIME field in the account control tables of the JCT. It is from this field that 

SMF obtains the ‘‘CPU time under TCBs”’ value for its records. 


Included/Excluded TCB Times 


Timing values accumulated for the address space under TCB control include: 
e Problem program time. 
SVCs 
Lock spins encountered in an MP environment 
EMS (emergency signals between CPUs) interrupt occuring within a lock spin 
Abend/Abterm 
User SPIE exit processing 


Times excluded are: 


I/O interrupt time 


External interrupt time 

Page fault processing 

CPU “stopped” time if the QUIESCE command is used 

RCT time (swap-out/swap-in processing and I/O error recovery processing) 2 
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e Attention processing time for TSO 


e Program check handling 


CPU Time Under SRBs 


When a job step is set dispatchable by the initiator, the accumulated job step time 
field for SRBs (ASCBSRBT) is initialized to zeros. SRB time is determined as 
follows: 


1, 


Whenever the SRB is dispatched; the CPU timer is set to a value that will not 
expire over a period of 208 days (208 day value). 


. Whenever the SRB terminates, the CPU tinir is accumulated by adding the 


difference between the 208 day value and the PSACPUT value to the 
ASCBSRBT value. 


ASCBSRBT = ASCBSRBT + (208 day value — PSACPUT) 


. [f an SRB is suspended for a page fix, page fault, the local lock, or the CMS 


lock, the CPU timer value is saved in the SSRB. Whenever the suspended SRB is 
redispatched, the CPU timer is reset from the saved value. Whenever the SRM 
and RMF timer expires, time spent in processing SRM and RMF is not included 
in SRB time. 


CPU timing is continually accumulated until the job step terminates. At that time 
the CPU time in the ASCBSRBT field is moved into the SCTSRBT field for use by 
SMF. 


Included /Excluded SRB Times 


Services that use SRBs to perform the following functions will have their 
execution time accumulated for the address space: 


e Swap control 

Cross-memory communications 

TQE scheduling 

Any supervisor service under SRB control 
SRM/RSM page stealing 

I/O completion processing 


The following functions will execute without affecting the time accumulated 


for the address space. 


@ Lock request suspension 
@ SRM and RMF timer expiration processing 
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CPU-Time Variation 


There are many reasons why CPU time varies between different runs of the same 
job or job step. The following list describes some of the major causes of variation: 


e Cycle stealing on systems with integrated channels — CPU 
instruction execution is temporarily suspended when channels require the use of 
hardware resources shared with the CPU. 


CPUs using.a high speed buffer — CPU time may vary due to any 

of the following: 

— Buffer interference caused by concurrent tasks 

— Partial or fuil disabling of a buffer because of storage errors 

— Translation lookaside buffer (TLB) affect on MIPS or instruction speed 


e Storage access — The CPU cannot access real storage if a channel is using it. 
Storage-access time depends on CPU architecture such as interleaving, data 
widths and paths. 


DASD space allocation — If the number of extents is not exactly the same as 
before, additional end-of-extent processing is required. 


e temporary i/O errors — Additional SVCs such as SVC 15 (ERREXCP), SVC 16 
(PURGE), and SVC 55 (EOV) may be required for temporary I/O errors. 


e@ EXCP request (SVC 0) — The time to process an EXCP request varies depending 
on the availability status of the requested device and channel. Some 
possibilities are: 

(a) The device and primary channel are available — the SIO preparation and 
execution are done immediately. 


(b) The device is available, the primary channel is busy, but one of the alternate 
channels is available — the time to test alternate channels is added to the 
time required in (a). 

(c) All devices and channels are busy — the request must be queued on a FIFO 
basis. 


e BLDL/FIND requests — If BPAM is used extensively, CPU time for processing 
BLDL/FIND requests varies if there was a change in the PDS directory. That is, 
a change in the location of the entry for the required member is reflected by a 
change in the time needed to find the block containing it. 


@ STOW processing — A difference in the PDS directory may also vary STOW 
processing time because of the additional reordering or bumping that may be 
necessary. 


e Macro processing — Processing time for macros such as LINK, LOAD, XCTL, 
ATTACH and BLDL is affected by where the requested module is located. For 
example, CPU time may be less if the module is in the LPA and joblibs and 
steplibs are not used. 
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Availability of serially reusable resources (locks), — System ENQ routine time will 
vary depending on whether the resource is available. If a resource is not available, 
additional time is taken to queue up the current request and to wake the 
requester. DEQ time also increases if other tasks have subsequently requested 

the resource that the current task is releasing. 


Wait processing — CPU time varies depending on whether or not ECBs have been 
posted prior to issuance of the WAIT macro instruction. 


Lock spins — If a job is run on an MP, CPU time may vary due to lock spins 
encountered in supervisor services. 


Queue searching — System service time varies with the status of the queue 
environment. For instance, the time to process an ENQ request varies with the 
number of QCBs to be examined and chained, and whether or not storage must 
be obtained for new QCBs. The time to process a GETMAIN request varies with 
the length of the FQE chain; FREEMAIN time varies with the status (free or 
allocated) of the adjacent areas. Also, global queue searching affects SVC time; 
for example, GETMAIN is greatly affected if storage is fragmented. 


Time requests — For task and real time requests, timer ENQ routine processing 
time varies with the number of elements on the timer queue that must be 
checked to find the proper slot for the current request. 


WTO, WTOR and WTL processing — CPU time may vary depending on the time 
required to find a free WQE and/or RQE, and possibly on whether a 
GETMAIN is necessary to build a new element. If the WTO or reply elements 
are at their limit, additional time is required for enqueuing. 


Generalized trace facility (GTF) — When GTF is active, CPU time increases 
depending on the system functions (SVC, SIO, IO, PCI, DSP) that are selected 
for current GTF recording. If USR functions are to be recorded and the 
application contains GTRACE macros, the CPU time variability is even more 
pronounced. 


FREEMAIN resulting in available real page — When a FREEMAIN results in 
making a real page available to an MP system, the page must be invalidated and 
both CPUs’ translation lookaside buffers must be purged of the entry. The 
invalidation and purge are synchronous: one CPU may wait (spin) a variable 
amount of time until the other CPU is enabled to receive a signal 

(EMS interrupt) and perform the synchronizing function. 


System resource manager (SRM) — SRM is run either scheduled ‘as an SRB, as a 
subroutine of quiesce (RCT), or as a subroutine of a service invoked by a job. 
SRM execution may cause CPU time to vary when it is invoked from supervisor 
services that issue SYSEVENTS, such as ENQ, WAIT (LONG=YES option), TPUT 
and TGET. 


SRM page stealing — SRM page stealing affects the number of page faults that 
a particular job incurs. CPU time varies depending on both the number of page 
faults resolved by I/O and the number of page faults resolved by reciaim. 


Sequential access method and chain scheduling — CPU time can vary from run 
to run depending on the amount of chain scheduling that was successful. The 
number of starts for 1/O will vary under different system loads. 
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Chapter 10: SMF Exit-System Interface Diagrams 


This chapter contains diagrams for each SMF exit that show the system 
interface(s) for the exit. Each diagram illustrates the general flow of events that 
occur before and after an SMF exit receives control. Note that the diagrams do 
not indicate the specific control path between system modules. 


The system interfaces for the following SMF exits are illustrated. 


Figure 10-1. 
Figure 10-2. 
Figure 10-3. 
Figure 10-4. 
Figure 10-5. 
Figure 10-6. 
Figure 10-7. 
Figure 10-8. 
Figure 10-9. 


IEFUJV — Job Validation Exit (Converter) 

IEFUJV — Job Validation Exit (Interpreter) 

IEFUJI — Job Initiation Exit and IEFUSI — Step Initiation Exit 
IEFUTL — Time Limit Exit 

IEFUSO — JES2 SYSOUT Limit Exit 

IEFUSO — JES3 SYSOUT Limit Exit 

ITEFU83 — SMF Record Exit 

IEFU84 — SMF Record Exit 

IEFACTRT — Termination Exit 


Figure 10-10. IEFUJP — JES2 Job Purge Exit 
Figure 10-11. IEFUJP — JES3 Job Purge Exit 
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Figure 10-1. IEFUJV — Job Validation Exit (Converter) 
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( Figure 10-2. IEFUJV — Job Validation Exit (Interpreter) 
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Figure 10-3. IEFUJI — Job Initialization Exit and IEFUSI — Step Initialization Exit 
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Figure 10-4. IEFUTL — Time Limit Exit 
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Figure 10-5. IEFUSO — JES2 SYSOUT Limit Exit 
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Figure 10-6. IEFUSO — JES3 SYSOUT Limit Exit 
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Figure 10-7. IEFU83 — SMF Record Exit 
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Figure 10-8. IEFU84 — SMF Record Exit 
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Figure 10-9. IEFACTRT — Termination Exit (Part 1 of 2) 
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Figure 10-9. IEFACTRT — Termination Exit (Part 2 of 2) 
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Figure 10-10. IEFUJP — JES2 Job Purge Exit 
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Figure 10-11. IEFUJP — JES3 Job Purge Exit 
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$P LNEn, record written when issued 6-124 

$S LNEn, record written when issued 6-113, 6-123 
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accounting 
field format 4-11 
interval 3-6 
started task 3-10 
TSO command = 3-7 
ACF/VTAM tuning statistics record (type 50) 6-122 
ACTIVE parameter 3-2 
adding devices to configuration 6-35, 6-52 
address space, SMF 1-1 
addressing SMF record fields 4-35 
ADYTRNS, record written by 6-224 
allocation 
dynamic 6-12 
JES3 device 6-60 
recovery 6-36 
allocation recovery record (type 10) 6-36 
ALTER access method services command, records written when 
issued 6-149, 6-153 
AMS command (see commands, access method services) 
ASMFCL procedure 
sort procedure, use in 5-3 
TESTEXIT procedure, use in 4-28 
authorization, preserving 2-13 
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billing by transaction 1-9 
branching to SMF exits 440 
buffer, SMF 1-1, 2-3 


C 
CANCEL 6-12 
CANCEL operator command 
relation to allocation recovery record 6-36 
relation to step termination record 6-12 
cataloged procedures 
ASMFCL 
sort procedure, usein 5-3 
TESTEXIT procedure, use in 4-28 
defining installation data setsin 4-6 
expanding before IEFUJV receives control 4-9 
channel path activity record (type 73) 6-174 
channel paths, valid and installed, records written for 6-174 
CICS/VS, record written by 6-230 
CICS/VS statistics record (type 110) 6-230 
clock,CPU 6-47 


closing magnetic tape volumes 6-47 
closing non-VSAM data sets 6-38, 6-42 
coding examples (see JCL examples) 
cold start, JES3 record written for 6-110 
commands 
access method services 
ALTER _ 6-149, 6-153 
DEFINE 6-141, 6-154 
DELETE 6-147, 6-151, 6-154 
causing record type90 6-224 
causing system status record 6-224 
operator 
$E LNEn, record written when issued 6-113, 6-116, 
6-115, 6-116 
$E SYS, record written when issued 6-109 
$P JES2, record written when issued 6-111 
$P LNEn, record written when issued 6-116, 6-124 
$S LNEn, record written when issued 6-113, 6-123 
CONFIG CHP, record written when issued 6-52 
CONFIG CPU, record written when issued 6-52 
CONFIG STOR, record written when issued 6-52 
DISPLAY SMF — 3-15 
HALT, operation 2-7 
HALT, record written when issued 6-49 
HALT EOD _ 6-224 
MODIFY TCAM, record written when issued 6-82 
S JES2, record written when issued 6-109 
SET DAE 6-224 
SET DATE 6-224 
SET DATE, record written when issued 6-34 
SETICS 6-224 
SET IPS 6-224 
SET MPF 6-224 
SET OPT 6-224 
SET SMF 6-224 
SET TIME 6-224 
SETDMN ~ 6-224 
SETSMF 6-224 
START, use with dump procedure 2-12 
SWITCH, operation 2-7 
SWITCH, record written when issued 6-47 
SWITCH SMF __ 6-224 
start networking, record written when issued 6-229 
common address space work record (type 30) 6-71 
common exit parameter area 4-7 
common service area (CSA), subpoolis 4-34 
communication among exit routines 4-33 
component, deleting 6-151 
concatenation request, record written when issued 6-107 
CONFIG CHP, record written when issued 6-52 
CONFIG CPU, record written when issued 6-52 
CONFIG STOR, record written when issued 6-52 
configuration 
adding devices to 6-35, 6-52 
removing devices from 6-37 
reportingon 1-11 
control blocks, SMF 1-1 
converter parameter field 4-11 
CPU activity record (type 70) 6-155 
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CPU clock 6-47 


CPU time 9-1 
job 9-1 
job step 9-1 


variations, major causes 9-1 
CPU time limits 4-15, 10-5 
cryptographic 

address 6-223 

initialization 6-214, 6-219 

record 6-209 

status 6-219 

unit support, record written for 6-219 
CSA (common service area), subpools in 4-34 


D 
DATABASE 2 Accounting, record written by 6-228 
DATABASE 2 Accounting, record-type 100 6-228 
DATABASE 2 Performance, record written by 6-229 
DATABASE 2 Performance, record type 102 6-229 
DATABASE 2 Statistics, record written by 6-229 
DATABASE 2 Statistics, record-type 101 6-229 
data collection parameters 
data set/direct access volume (DSNAME) 3-2 
SMF/user records (TYPE) 3-2 
system/job/step (SYS or SUBSYS) 3-3, 34, 3-5 
temporary data set (REC) 3-2 
data lost record (type 7) 6-33 
data set activity records 
INPUT or RDBACK (type 14) 6-38 
OUTPUT, UPDAT, INOUT, or OUTIN (type 15) 6-42 
data set status records 
rename (type 18) 6-46 
scratch (type 17) 6-45 
data sets 
DD* 6-12, 6-86 
DD DATA _ 6-12, 6-86 
installation-defined 4-6,4-7 
non-VSAM __ 6-23, 6-46 
SMF (see SMF data sets) 
spin (JES2) 6-20 
spin (JES3) 6-25 
DD* data sets 6-12, 6-86 
DD DATA data sets 6-12, 6-86 
DD level EXCP count 8-1 
deconcatenation request, record written when issued 6-107 
DEFINE access method services command, records written 
when issued 6-141, 6-154 
DEFINE utility 2-4 
defining the useof SMF 3-1 
degradation billing 1-7 
DELETE access method services command, records written 
when issued 6-147, 6-151, 6-154 
demounting user volumes 6-47 
designing areport program 1-4,5-4 
detail recording, testing of 4-42 
determining interval time 4-41 
device activity record (type 74) 6-176 
device allocation record, JES3 (type 25) 6-60 
device allocation recovery record (type 10) 6-56 
DEVICE option, record written for specified devices 6-176 
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devices 
direct access 6-47 ‘ 


move offline 6-37, 6-52 
move online 6-35, 6-52 
online atIPL 6-52 
recovering 6-35 
reporting on 1-11 
direct access volume activity, reporting on 1-13 
direct access volume record (type 19) 6-47 
direct access volume/data set parameter (DSNAME) 3-2 
DISPLAY SMF command 3-15 
distribution libraries, for adding exit routines 2-1 
DSNAME parameter 3-2 
dummy records, performatting data set with 2-4, 5-1 
dump exit routine (see IEFU29 exit routine) 
dump header record (type 2) 6-10 
dump options, SMF 2-9 
dump program, SMF (see IFASMFDP) 
dump trailer record (type 3) 6-11 
dumping SMF data sets (see IFASFMDP) 
dynamic DD record (type 40) 6-89 


E 
efficiency billing 1-8 
end-of-volume 
records written at 
fornon-VSAM data sets 6-38, 6-42 
for tape volumes 6-50 
ENQ/DEQ, contention, resources identified 6-185 
enqueue activity record (type 77) 6-185 
ERBMFBPC, record written by 6-198 
ERBMFDCP, record written by 6-155 
ERBMFDDP, record written by 6-176 
ERBMFDEQ, record written by 6-185 
ERBMFDHP, record written by 6-174 
ERBMFDOQ, record written by 6-188 
ERBMFDPP, record written by 6-162 
ERBMFDSP, record written by 6-178 
ERBMFDTP, record written by 6-182 
ERBMFDWP, record written by 6-171 
ERBSMFR mapping macro, for RMF records 6-155 
error statistics by volume record (type 21) 6-50 
event recording (see also IEFUTL, IEFUSO, and IEFU83 exits) 
examples 
(see also JCL examples) 
SMF data set space requirements 2-4 
SMFFRMT output 54 
summary activity report 2-15 
use of SMF data 1-5 
EXCP counts 
address space level 8-1 
DD level 8-1 
executing the SMF dump program 2-11 
exit routines 
SMF 
adding to operating system 2-1 
branchingto 4-40 
characteristicsof 4-1 
common parameters 4-7 
communicating among 4-33 








conventions 4-6 
facilities 4-33 
IEFACTRT (termination exit) 4-20, 10-10 
IEFUJI (job initiation) 4-11, 104 
IEFUJP (JES2 job purge) 10-12 
IEFUJP (JES3 job purge) 10-13 
IEFUJP (job purge) 4-22 
IEFUJV (job validation) 4-9 
IEFUJV (job validation-converter) 10-2 
IEFUJV (job validation-interpreter) 10-3 
IEFUSI (step initiation) 4-12, 10-4 
IEFUSO (JES2 SYSOUT limit) 10-6 
IEFUSO (JES3 SYSOUT limit) 10-7 
IEFUSO (SYSOUT limit) 4-17 
IEFUTL (time limit) 4-15, 10-5 
IEFU29 (SMF dump) 4-23 
IEFU83 (SMF record-SMFWIM macro) 10-8 
IEFU84 (SMF record) 4-18 
IEFU84 (SMF record-SMFEWTM macro) 10-9 
including in operating systems 2-1 
introduction to 4-1 
load module assignments for 2-1 
modules interfacing with 4-2, 4-3 
obtaining additional work areas for 4-34 
parameters passed to 4-2, 4-3 
restrictions 4-5 
return codes 4-2, 4-3 
sample routines 4-3 
system interface diagrams 10-1 
testing 4-25 
using installation-defined data sets with 4-6 
when taken 4-2, 4-3 

external writer, record written by 6-20 


F 
field name, record written for 6-182 
full SMF dataset 2-6 


G 

GENKEY function 6-215, 6-220 
GETMAIN macro instruction 4-26 
global recording options, specifying 3-3 


H 
HALT EOD, operator command, module writing SMF record 
type90 6-224 
HALT operator command 
function 2-7 
record written whenissued 6-47 
HASPINIT, record writtenby 6-109 
HASPMISC, record written by 6-62, 6-109 
HASPNET, record written by 6-57, 6-127, 6-129, 6-131 
HASPNUC, record written by 6-111 
HASPPRPU, record written by 6-20 


HASPRDR, record written by 6-57 

HASPRTAM, record written by 6-113, 6-116, 6-120, 6-121, 
6-124, 6-126 

header, standard SMF record 6-1 

header, standard SMF record, with subtypes 6-2 

header, standard SMF record, without subtypes 6-3 

hot start, JES3 record written for 6-110 


J 
IASXSD82, record written by 6-20 
IATINTK, record written by 6-110, 6-112 
IATMDBIC, record written by 6-60 
IATNTSD, record written by 6-130 
IATOSWD, record written by 6-25 
IATPURG, record written by 6-60, 6-66 
IATRJM3, record written by 6-117, 6-121 
IATRIJM4, record written by 6-117 
IATSNDT, record written by 6-114 
IATSNLC, record written by 6-117 
IATSNLS, record written by 6-11 
ICB2MSG, record written by 6-35, 6-37, 6-52 
ICF alter activity record (type 66) 6-149 
ICF catalog record 
deleted 6-147, 6-149 
record written when inserted or deleted 6-144 
updated 6-147 
written 6-149 
ICF define activity record (type 61) 6-144 
ICF delete activity record (type 65) 6-147 
ICTCRY82 mapping macro, use in symbolically addressing 
record type 82 6-215, 6-220 
ICTMKGO00, record written by 6-214 
ICTMKMO1, record written by 6-214 
ICTMKO04, record written by 6-214 
ICTSMF82 mapping macro, use in symbolically addressing 
record type 82 6-215 
ICUCRY82 mapping macro, use in symbolically addressing 
record type 82 6-220 
ICUMKM10, record written by 6-219 
ICUMKM11, record written by 6-219 
ICUMKM14, record written by 6-219 
ICUSMF82 mapping macro, use in symbolically addressing 
record type 82 6-220 
IDA0192S, record written by 6-140, 6-143 
IEBDG utility program, creating sample parameter lists with 
4-25, 4-31 
IEBGENER utility program, executing TESTEXIT with 4-28 
IEBPTPCH utility program 
use in 
sample exit routines 4-4 
sample sort routines 5-2 
TESTEXIT 4-27 
IEBUPDTE utility program 
adding exit routine to EXITLIB with 4-27 
adding SMIF-PRMxx to SYS1.PARMLIB 3-13 
executing SMF dump program with 2-13 
executing TESTEXIT with 4-27 
IEDAY1, record written by 6-82 
IEECLEAN, record written by 6-35, 6-37, 6-52 
IEEMB805, record writtenby 6-224 
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IEEMB812, record written by 6-224 
IEEMB823, record written by 6-52, 6-224 
IEEMB829, record written by 6-33, 6-224 
IEEMB8 36, record writtenby 6-71 
IEEMB842, record written by 6-56 
IEEMB846, IBM-supplied module 3-8 
IEEMBPVST, record written by 6-52 
IEEVPTH, record written by 6-35, 6-37 
IEEVSTGL, record written by 6-52 
IEE2303D, record written by 6-35 
IEE70110, record written by 6-224 
IEE8603D, record written by 6-224 
IEFAB421, record written by 6-37 
IEFAB488, record written by 6-36 
IEFACTRT exit routine 4-20 

diagram of system interfaces 10-10 

parameters passed 4-21 

return codes 4-21 

sample routine 4-5 

System Availability Management (SAM) Function 4-20 

writing system output messages 4-21 
IEFAEASI, record written by 6-71 
IEFDB4F9, record written by 6-107 


IEFSMFIE, record writtenby 6-49, 6-71 
IEFTB721 
record written by 6-71, 6-83 
job termination 6-91 
step termination 6-86 
IEFTB722 
record constructed by 
job termination 6-17, 6-91 
step termination 6-12, 6-86 


IEFTB727, record written by 6-83 
IEFUJI exit routine 4-11 

diagram of system interface 10-4 

parameters passed 4-12 

return codes 4-12 

sample routine 44 

Sample Availability Management (SAM) Function 4-11 
IEFUJP exit routine 4-22 


diagram of system interface 10-12, 10-13 
parameters passed 4-22 
return codes 4-22 
IEFUJV exit routine 4-9 
diagram of system interface 10-2, 10-3 


parameters passed 4-10 
return codes 4-11 
sample routine 4-4 
IEFUSI exit routine 4-12 
diagram of system interface 10-4 
parameters passed 4-13 
return codes 4-13 
IEFUSO exit routine 4-17 
diagram of system interface 
parameters passed 4-17 
return codes 4-17 
IEFUTL exit routine 4-15 
diagram of system interface 10-5 
parameters passed 4-16 
return codes 4-16 
sample routine 44 
IEFU29 exit routine 4-29 
parameters passed 4-23 
return codes 4-23 


10-6, 10-7 
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IEFU83 exit routine 4-17 
and the SMFWTM macro 


diagram of system interface 


parameters passed 4-18 
return codes 4-18 
sample routine 4-5 
IEFU84 exit routine 4-18 
and the SMFEWTM macro 


diagram of system interface 


parameters passed 4-19 

restrictions 4-6 

return codes 4-19 
IEF6503D, record written by 
IFASMFDP dump program 


CLEAR function of 2-13 


defining the use of 2-9 


4-36 
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4-37 
10-9 


6-224 


dumping SMF data sets 2-6 


executing 2-11 
records written by 
return codes 2-13 
sample JCL for executing 


6-10, 6-11 


2-11 


sample procedure using START command 2-12 


termination of processing 


2-6, 5-1 


use in creating data sets 5-1 
use in preformatting data sets 2-4 


IFASMFR macro instruction 
IFG0202H, record written by 
IFGO202I, record written by 
IFHSTATR utility program 
IGCOOOSI, record written by 
IGCO009A, record written by 
IGC0012F, record written by 
IGC0107H, record written by 
IGCO90SI, record written by 
IGGOCLBV, record written by 
IGGOCLED, record written by 
IGG0290D, record written by 
IGG03001, record written by 
IGX00017, record written by 
initial program load (see IPL) 
initialization, TIOC 6-82 


initiation record, job (type 20) 


4-35 


6-38, 6-42 
6-38, 6-42 


6-50 


6-37 
6-50 
6-52 
6-47 
6-37 
6-141, 6-151, 6-153, 6-154 
6-136, 6-138, 6-149 
6-45 
6-46 
6-43 


6-49 


INOUT, OUTPUT, UPDAT, or OUTIN data set activity record 


(type 15) 6-42 


INPUT or RDBACK data set activity (type 14) 6-38 


input/output (see I/O) 
installation defined data sets 


4-5, 4-6 


installation-written routine (see user-written routines) 
Integrated Catalog Facility, records written by (see IGGOCLED 


and ICF) 
integrity 
JES2 record for 
JES3 record for 6-121 
interlock warming 4-15 
interval accounting 3-6 
interval time 4-41, 4-42 


6-120, 6-126 


I/O, queuing activity, record written for 6-188 
I/O configuration record (type 8) 6-34 
I/O macro instruction (SMFWTM) 


format 4-36 
return codes 4-36 








IPL records 
configuration (type 22) 6-52 
direct access volume (type 19) 6-47 
I/O configuration (type 8) 6-34 
IPL (type0) 6-5 

ISTINCTS, record written by 6-122 


J 
JCL examples 
adding exit routinesto EXITLIB 4-27 
adding exit routines to SYSI.LPALIB 2-2 
adding SMFPRMO1 to SYS1.PARMLIB = 3-13 
allocating space for SMF data sets 2-4 
cataloging SMF datasets 2-4 
dumping SMF data sets using START command 2-12 
executing a sort procedure 5-3 
executing SMF dump program 2-11 
executing SMFFRMT 5-5 
executing TESTEXIT 4-29 
obtaining a list of sample exit routines 4-3 
obtaining a list of sample sort exit routines 5-2 
JES2 integrity record (type 49) 6-120 
JES2 integrity record (type 54) 6-126 
JES2 LOGOFF/stop line record (type 53) 6-124 
JES2 LOGON/start line record (type 52) 6-123 
JES2 network integrity record (type 56) 6-128 
JES2 network SIGNOFF record (type 58) 6-131 
JES2 network SIGNON record (type 55) 6-127 
JES2 network SYSOUT transmission record (type 57) 6-129 
JES2 records 
JES2 integrity (type 49) 6-120 
JES2 integrity (type54) 6-126 
JES2 job purge (type 26) 662 
JES2 LOGOFF/stop line record (type 53) 6-124 
JES2 LOGON/start line record (type 52) 6-123 
JES2 network integrity record (type 56) 6-127 
JES2 network SIGNOFF record (type 58) 6-131 
JES2 network SIGNON record (type 55) 6-127 
JES2 network SYSOUT transmission record (type 57) 
6-129 
JES2 SIGNOFF/stop line (type 48) 6-114 
JES2 SIGNON/start line (type 47) 6-113 
JES2 spool offload (type 24) 6-57 
JES2 start (type 43) 6-109 
JES2 write (type 6) 6-20 
JES2 start record (type 43) 6-109 
JES2 withdrawal record (type 45) 6-111 
JES3 initialization, record written during 6-110 
JES3 integrity record (type 49) 6-121 
JES3 networking SYSOUT transmission record (type 57) 
6-130 
JES3 records 
JES3 device allocation (type 25) 6-60 
JES3 integrity (type 49) 6-121 
JES3 job purge (type 26) 6-67 
JES3 networking SYSOUT transmission record (type 57) 
6-130 
JES3 SIGNOFF/stop line/LOGOFF (type 48) 6-117 
JES3 SIGNON/start line/LOGON (type 47) 6-114 
JES3 start (type 43) 6-110 
JES3 stop record (type 45) 6-112 
JES3 writer (type 6) 6-25 


JES3 start record (type 43) 6-110 
JES3 stop record (type 45) 6-112 
job CPU time limit 6-34 
job initiation exit routine (see IEFUJI exit routine) 
job initiation record (type 20) 6-49 
job output element, record written by 6-20 
job purge exit routine (see IEFUJP exit routine) 
job purge record 
JES2 (type 26) 6-62 
JES3 (type 26) 6-66 
job termination records 
for background jobs (type5) 6-17 
for foreground jobs (type 35) 6-91 
job validation exit routine (see IEFUJV exit routine) 
job wait time limit 10-5 
changing value of 4-15, 4-16 
specifying (JWT parameter) 3-3 
JWT parameter (see job wait time limit) 


K 
key, storage protect 4-6 
key generator utility 6-215, 6-220 


L 

libraries, distribution, for adding exit routines 2-1 
LISTDSN parameter 3-2 

load module assignment for exit routines 2-1 
local system queue area (LSQA), subpools in 4-34 
logical control unit, record written for 6-188 
logoff record (type 35) 6-91 

logon, record written for 6-49 

LONG=YES parameter, use with WTOR macro 4-6 
lost data, minimizing 3-6 

LSQA (local system queue area), subpools in 4-34 


M 
macro instructions 
GETMAIN 4-26, 4-34 
IFASMFR- 4-35 
SMFDETAL 4-42 
SMFEWTM 4-37 
SMFINTVL 4-41 
SMFRTEST 4-39 
SMFWTM 4-36 
WAIT 4-7 
WTOR 4-7 
magnetic tape volumes, error statistics record 6-50 
MANX data set, SMFWTM macro definition for writing to 
4-26 
mass storage control (MSC) 
configuration 6-52 
move offline 6-37 
move online 6-35 
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MAXDORM parameter 3-3 
measurement interval, record written for 6-162,6-185, 6-198 
messages 
SYSOUT 

from IEFACTRT = 4-20 

from IFASMFDP 2-7 

from SMF data set status 3-2 
MODIFY TCAM operator command, record written when 

issued 6-82 

module assignments for exit routines 2-1 
modules interfacing with exit routines 4-3 
Monitor I activity record (type 78) 6-188 
Monitor II, reports, record subtype sections 6-198 
Monitor II activity record (type 79) 6-198 
MSC (see mass storage control) 
MVS/BDT, file-to-file transmission record (type 59) 6-132 


N 
network 
Logical Data Manager (NLDM) 6-101 
Performance Monitor Statistics (NPM) 6-100 
SIGNOFF record 6-131 
SYSOUT transmission 6-129, 6-130 
termination of asession 6-131 
problem determination application record see NPDA 
networking, start command, record written when issued 
6-127 
NOACTIVE parameter 3-2 
NODETAIL parameter 3-4 
NOEXITS parameter 3-4 
NOINTERVAL parameter 3-4 
NOLISTDSN parameter 3-2 
NOMAXDORM parameter 3-3 
non-temporary data sets 
REC parameter, use in writing SMF record type 17 6-45 
scratching 6-45 
non-VSAM data set activity records, INPUT or RDBACK 
(type 14) 6-38 
non-VSAM data sets 
closing 6-38 
renaming 6-46 
NOPROMPT parameter 3-3 
NOSTATUS parameter 3-3 
NOTYPE parameter 3-3 
NPDA record (type 37) 6-94 


O 
opening VSAM components or clusters 6-140 
operation of SMF, overview 1-1 
operator commands (see commands, operator) 
OUTIN, OUTPUT, UPDAT, or INOUT data set activity record 
(type 15) 6-42 
OUTLIM parameter 4-17 
OUTPUT, UPDAT, INOUT, or OUTIN data set activity record 
(type 15) 6-42 
output writer record 
JES2 (type 6) 6-20 
JES3 (type 6) 6-25 
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P 
page data set, record written for 6-179 
page/swap data set activity record (type 75) 6-179 
paging activity record (type 71) 6-162 
parameter area,commonexit 4-7 
parameters 
SMFPRMxx 
adding or replacing from console 3-14 
coding restrictions 3-13 
contents and formats 3-4 
defaults 3-12 
entering into SYS1.PARMLIB 3-12 
selecting records using 3-12 
using the DISPLAY SMF command = 3-15 
using the SET SMF command = 3-13 
subsystem 
changing 444 
determining 443 
performance 2-7 
performance group, record written for 6-171 
programmed cryptographic facility, record written for 6-214 
purging a job 
JES2 6-62 
JES3 6-66 


R 
RACF (Resource Access Control Facility) 649, 6-213 
RACF initialization record (type 81) 6-213 
RACF processing record (type 80) 6-213 
RDBACK or INPUT data set activity record (type 14) 6-38 
RDW (record descriptor word) 4-36, 4-38, 6-1, 6-2, 6-3 
REC parameter 3-2 
record descriptor word (see RDW) 
record interval, how to specify 3-6 
record length, minimum for using sort 5-1 
recording not available record (type 7) 6-33 
recording status changes 3-10 
records 
SMF 
addressing 4-35 
contents and formats 6-5, 6-6, 6-7 
segmenting 2-6 
selecting 3-12 
sorting 5-1 
standard header 6-1 
summary of 6-4 
testing recordingof 4-42 
types (see Table of Contents for specific types) 
recovery allocation record (type 10) 6-36 
reenterable attribute 4-5 
register usage 4-6 
remote user 
JES2 
record written when signing off 6-124 
record written when signing on 6-120, 6-123 
JES3, record written when signing on 6-121 
removing devices from configuration 6-37, 6-52 
renaming non-VSAM data sets 6-46 
report, summary activity 2-14 
report programs 1-5,54 
restarting a line, JES2 6-116, 6-123, 6-124 
restarting SMF, use of SET SMF operator command 3-13 
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restrictions 
exit routines 
(see also restrictions, SMF) 
adding exit routines to system 2-1 
adding or modifying JCL 4-9, 4-11 
coding the TIME=parameter 4-16 
communicating with IEFU83 4-18 
communicating with IEFU84 4-18 
extending job/step execution time 4-16 
reenterable attribute 4-5 
system interlock 4-15 
writing to system defined datasets 4-5,446 
WTOR macro instructions 4-7 
SMF (see also restrictions, exit routines) 
coding SMFPRMxx parameters 3-13 
maximum SYSOUT message length 4-21 
RETKEY function 6-215, 6-220 
return codes 
IEFACTRT exit routine 4-20 
IEFUJI exit routine 4-11 
IEFUJP exit routine 4-22 
IEFUJV exit routine 4-9 
IEFUSI exit routine 4-12 
IEFUSO exit routine 4-17 
IEFUTL exit routine 4-15 
IEFU29 exit routine 4-23 
IEFU83 exit routine 4-17 
IEFU84 exit routine 4-18 
SMF dump program = 2-7 
SMFCHSUB 4-44 
SMFDETAL 4-42 
SMFEWTM = 4-37 
SMFEXIT 4-40 
SMFINTVL 4-41 
SMFRTEST 4-39 
SMFSUBP 4-43 
SMFWIM 4-37 
RMF 
measurement interval, record written atendof 6-179 
Monitor Iactivity 6-188 
Monitor II activity 6-198 
records produced by 6-155 
routines 
user-written exit (see exit routines, SMF) 
user-written exit report 5-4 


S 
S JES2, record written when issued 6-109 
sample data set space requirements 2-5 
sample DD statements 2-4 
sample exit routines 4-4 
sample job, dumping SMF data sets 2-12 
sample sort procedure 5-2 
sample uses of SMF data 1-4 
analyzing the configuration 1-11 
billing users 1-5 
evaluating data set activity 1-14 
profiling system resource usage 1-5, 1-15 
reporting reliability 1-10 
scheduling jobs 1-11 
summarizing DASD volume activity 1-13 


saving registers 4-6 
scratching 
non-temporary datasets 6-45 
temporary data sets 6-45 
security record (type 82) 6-214, 6-219 
service level reporter, use of 1-5 
session termination, record written for 6-162, 6-185, 6-198 
SET DAE, operator command, module writing SMF record 
type90 6-224 
SET DATE 
operator command 
module writing SMF record type90 6-224 
record written when issued 6-34 
SET ICS, operator command, module writing SMF record type 
90 6-224 
SET IPS, operator command, module wirting SMF record type 
90 6-224 
SET MPF, operator command, module writing SMF record 
type90 6-224 
SET OPT, operator command, module writing SMF record 
type90 6-224 
SET SMF 
operator command 
module writing SMF record type 90 6-224 
tracking 3-10 
use in modifying options 3-13 
use in restarting SMF 3-13 
use in specifying SMFPRMxx parmlib member 3-13 
useof 3-1 
used torestart SMF 1-1 
SET TIME, operator command, module writing SMF record 
type90 6-224 
SETDMN, operator command, module writing SMF record 
type90 6-224 
SETSMF 
operator command 3-14 
module writing SMF record type90 6-224 
useof 3-l 
SID parameter 3-2 
SIGNOFF, JES2 network record 6-131 
SIGNOFF/stop line record, JES2 (type 48) 6-116 
SIGNOFF/stop line record/LOGOFF, JES3 (type 48) 6-219 
SIGNON/start line record, JES2 (type 47) 6-113 
SIGNON/start line record/LOGON, JES3 (TYPE 47) 6-114 
SMF 
address space 1-1 
buffer 1-1 
number 2-3 
size 2-3 
control blocks 1-1 
data sets 
preformatted with dummy records 2-6, 5-1 
defining the use of 3-1 
definition 1-1 
dump program, use in creating data sets 5-1 
exit (see exit routines, SMI) 
functions 3-6 
options, replacing 3-13 
overview  1-l 
performance 2-7 
recordexit 4-18, 10-8, 10-9 
records 
fieldsin 7-1 
records containing field 7-1 
restrictions (see restrictions, SMF) 
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SMF buffer 2-3 
storage requirements 2-3 
SMF data sets 
allocating space for 2-4 
cataloging 2-4 
determining which to write first 14 
dumping (see IFASMFDP) 
naming 1-4 
procedure when full 2-6 
specifying in SMFPRMxx parameters 3-1 
status messages 3-2 
switching 2-7 
writing and using 
SMFDETAL macro 4-42 
SMFEWTM macro 4-37 
SMFEXIT macro 4-40 
SMFINTVL macro 4-41 
SMFRTEST macro 4-39 
SMFWTM macro 4-36 
SMF dump exit routine (see IEFU29 exit routine) 
SMF dump program (see also IFASMFDP) 
defining use of 2-9 
executing 2-11 
options 2-9 
syntax errors 2-10 
SMF exit control area 3-3 
SMF exit routines (see exit routines, SMF) 
SMF exits, system interface diagrams 10-1 
SMF performance 2-7 
SMF record exit (see IEFU83 and IEFU84 exit routines) 
SMF recording options, modifying 3-13 
SMF records (see records, SMF) 
SMF statistics, collecting 3-6 
SMF status, displaying 3-15 
SMF status record (type 23) 6-56 
SMF writer routine, switching data sets 2-6 
SMFCHSUB macro 4-44 
SMFDETAL macro 4-42 
SMFEWTM macro 4-37 
SMFEXIT macro 4-40 
SMFEXITS sample exit routines 4-3 
SMFEI15 sample sort routine 5-1 
SMFE35 sample sort routine 5-1 
SMFFRMT procedure 5-5 
SMFINTVL macro 4-41 
SMFPRMxx parameters 
adding or replacing fromconsole 3-14 
coding restrictions 3-13 
contents andformats 3-2, 3-3, 3-4 
defaults 3-12 
entering into SYSI1.PARMLIB 3-12 
functions controlled by 3-6 
selecting records using 3-12 
using the DISPLAY SMF command = 3-15 
using the SET SMF command = 3-13 
SMFRTEST macro 4-39 
SMFSORT procedure 5-1 
SMFSUBP macro 4-43 
SMFWTM macro 4-36 
sorting SMF records 
minimum record length 4-6 
sample sort procedure 5-3 
sample sort/merge exit routines 5-1 
sort/merge statistics record (type 16) 6-43 
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spin data sets 
JES2 record written for 6-20 
JES3 record written for 6-25 
spool offload data sets 
JES2 record written for 6-57 
SQA (system queue area), subpools in 4-31 
standard SMF header 6-1 
START operator command, use with SMF dump program 
2-12 
started task accounting 3-10 
starting a line 
JES2 6-109, 6-123 
JES3 6-114 
starting JES2 6-109 
starting JES3 6-110 
statistics, collecting SMF 3-6 
status changes, recording 3-10 
STATUS parameter 3-3 
step CPU time limit 4-15, 4-16, 10-5 
step initiation exit routine (see IEFUSI exit routine) 
step termination records 
for background jobs (type 4) 6-12 
for foreground jobs (type 34) 6-86 
stopping a line 
JES2 6-116, 6-124 
JES3 6-117 
storage protect keys 4-6 
SUBPARM parameter 3-5 
subpools 
required for additional work areas 4-34 
required when using TESTEXIT 4-28 
SUBSYS parameter 3-5 
to control started task accounting 3-10 
subsystem 
data, specifying 3-5 
definition of 3-5 
parameters 
changing 4-44 
determining 4-43 
passing datato 3-11 
summary activity report 2-14, 2-15 
swap data set, record written for 6-179 
SWITCH operator command 
function 2-7 
record written when issued 6-47 
SWITCH SMF, operator command, module writing SMF record 
type90 6-224 
switching recording on SMF datasets 1-4, 2-7 
symbolically addressing SMF fields 4-36 
SYS parameter 3-3 
SYSOUT limit exit routine (see IEFUSO exit routine) 
SYSOUT messages 
from IEFACTRT 4-20 
from IFASMFDP 2-7 
SYSOUT transmission, network 6-129, 6-130 
System Availability Management (SAM) Function 
IEFACTRT — Termination Exit 4-20, 10-11 
IEFUJI — Job Initiation Exit 4-11, 10-4 
system identifier 
parameter (SID) 3-2 
specifying 3-2 
system interlock warning 4-15 
system output messages 
from IEFACTRT 4-20 
from IFASMFDP 2-7 











system queue area (SQA), subpoolsin 4-34 
system resource usage, reporting on 1-15 
system status record (type 90) 6-122 
SYS1.ALPALIB, addressing exit routinesto 2-1 
SYS1.AOSB3, adding exit routines to 2-1 
SYS1.AOS00, adding exit routines to 2-1 
SYS1.ASMPLIB 

SMFEXITS 4-3 

SMFE15 = 5-1 

SMFE35 5-1 

SMFFRMT_ 5-4 

SMFSORT 5-1 

TESTEXIT 4-26 
SYSI1.MACLIB 4-35 
SYS1.MANn (see SMF data sets) 
SYS1.PARMLIB, adding SMFPRMxx member to 3-12 
SYS1.RMFMACO1,ERBSMFR resides in 6-155 


T 
temporary data sets 
REC parameter, use in writing SMF record type 17 6-45 
scratching 645 
termination exit rotuine (see IEFACTRT exit routine) 
TESTEXIT procedure 4-25 
testing detailrecording 4-42 
testing exit routines 4-25 
testing record recording 4-29 
throughput 2-7 
time extension, minimum 4-16 
time limit exit routine (see IEFUTL exit routine) 
time limits 4-15, 10-5 
TIOC initialization record (type 31) 6-82 
trace activity record (type 76) 6-182 
transaction billing 1-9 
developing method of 1-9 
for heavy TSO users 1-6 
transactional data, written by CICS/VS 6-230 
TSO 
command accounting 3-7 
objectives 1-6 
records 
logoff (type 35) 6-86 
step termination (type 34) 6-86 
user work accounting (type 32) 6-82 
tuning statistics, ACF/VTAM 6-122 


U 
unallocation request, record written when issued 6-107 
unit 
cryptographic 

address 6-220 

status 6-220 
UPDAT, OUTPUT, INOUT, or OUTIN data set activity record 

(type 15) 642 

use of SMF data, sample, 14 
user communication field 4-7 


user-defined data set 4-6 
user-identification field 4-7 
user-written exit routines (see exit routines, SMF) 
user-written exit routines 
exit (see exit routines, SMF) 
report 1-4 


V 

VARY device OFFLINE record (type 11) 6-37 
VARY device ONLINE record (type 9) 6-35 
volume error statistics record (type 21) 6-50 


volumes 
tape 6-50 
VSAM) 6-143 


VSAM catalog entries 

defining 6-141 

deleting 6-41 

extending 6-141 

renaming 6-153 
VSAM cluster 

closing 6-143 

defined closed or deleted 6-136 

opening 6-140 
VSAM component 

closing 6-143 

opening 6-140 
VSAM component or cluster opened record (type 62) 6-140 
VSAM component or cluster status record (type 64) 6-143 
VSAM components or clusters, closing 6-135, 6-143 
VSAM data space defined, extended or deleted record 

(type 69) 6-154 

VSAM data spaces 

defining 6-154 

deleting 6-154 

extending 6-154 
VSAM entry defined record (type 63) 6-141 
VSAM entry deleted record (type 67) 6-141 
VSAM entry renamed record (type 68) 6-153 
VSAM volume data set updated record (type 60) 6-136 
VSAM volume record, record written when added or deleted 

6-136 

VSAM volumes 

space unavailable on 6-143 

switching 6-143 
VSPC, records written by 6-109, 6-111, 6-113, 6-116, 6-120 


W 

WAIT macro instruction 4-7 

wait time, specifying limit 3-3 

work areas, obtaining 4-34 

workload activity record (type 72) 6-171 
WORKREG, register used in 31-bit addressing 4-40 
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